v1

latestOpenAPI 3.1.02026-08-04151221521.2 KB
Registry

Get registry credentials for pushing agent images

Get short-lived credentials for pushing images to a namespace's registry.

Each namespace has its own isolated registry repository. The token returned
can ONLY push images to the specified namespace's repository.

The CLI uses this endpoint to authenticate with Docker before pushing
agent images. Returns a token valid for approximately 1 hour.

**Usage with Docker:**
```bash
docker login {registry_url} -u {username} -p {token}
docker push {registry_url}/{repository}/{agent}:{tag}
```
get/registry/auth

Query parameters

namespacestring required

Target namespace slug for the image push

Example:acme

Target namespace slug for the image push

Response

Successful Response

expires_atstring date-time required

Token expiration timestamp (typically ~1 hour from issuance)

registry_urlstring required

Docker registry host URL (e.g., us-east4-docker.pkg.dev)

repositorystring required

Repository path within the registry (e.g., project-id/agents)

tokenstring required

Short-lived OAuth2 access token for docker login

usernamestring

Username for docker login (always 'oauth2accesstoken' for GCP)