> ## Documentation Index
> Fetch the complete documentation index at: https://onecli.sh/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Utility API: Counts, Vaults, and Agent Bootstrap

> Get workspace counts, list vault connections and runners, and fetch container config and credential stubs with the OneCLI API.

The utility endpoints cover helpers that don't fit one resource. They return workspace counts, vault connections, and hosted-agent runners, and they give you what you need to start an agent behind the gateway.

Use the bootstrap helpers when you wire a container or coding agent to OneCLI. See [Coding agents](https://onecli.sh/docs/guides/coding-agents.md) for the full setup.

## Related guides

* [Coding agents: route agents through the gateway](https://onecli.sh/docs/guides/coding-agents.md)
* [Vaults overview](https://onecli.sh/docs/vaults/overview.md)

## Endpoints

| Endpoint | Method and path | What it does |
| - | - | - |
| [Get resource counts](https://onecli.sh/docs/api-reference/utility/get-resource-counts.md) | `GET /counts` | Get headline counts for the current workspace, such as how many agents and secrets it holds. |
| [List vault connections](https://onecli.sh/docs/api-reference/utility/list-vault-connections.md) | `GET /vaults` | List the workspace's external vault connections, such as 1Password and Bitwarden, and their status. |
| [List runners](https://onecli.sh/docs/api-reference/utility/list-runners.md) | `GET /runners` | List the deployment's hosted-agent runners and whether each one is alive. |
| [Get an agent's container configuration](https://onecli.sh/docs/api-reference/utility/get-an-agents-container-configuration.md) | `GET /container-config` | Get the environment variables, CA certificate, and credential stubs to point a container at the gateway as an agent. |
| [List agents with credential stubs](https://onecli.sh/docs/api-reference/utility/list-agents-with-credential-stubs.md) | `GET /credential-stubs` | List the coding agents that need a local credential stub file to start and route traffic through the gateway. |
| [Get a credential stub](https://onecli.sh/docs/api-reference/utility/get-a-credential-stub.md) | `GET /credential-stubs/{agent}` | Get the placeholder credentials file a coding agent needs locally. |
| [Get the gateway skill](https://onecli.sh/docs/api-reference/utility/get-the-gateway-skill.md) | `GET /skill/gateway` | Get the Markdown skill that teaches a coding agent how to use the OneCLI gateway, tailored to a framework. |

## Next steps

* [API overview](https://onecli.sh/docs/api-reference.md): base URLs, authentication, and pagination
* [Errors](https://onecli.sh/docs/api-reference/errors.md): status codes and the error format
* [Editions](https://onecli.sh/docs/api-reference/editions.md): which endpoints each edition serves


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.