---
title: "Register Container"
method: POST
path: "/versions/register"
tags: ["Versions"]
---

# Register Container

`POST /versions/register`

Register an agent container that has started up.

    Called by the agent container on startup to:
    1. Register its ACP URL with the platform
    2. Receive its API key for authenticating subsequent requests

    This endpoint should be called from within the container's entrypoint
    after the ACP server is ready to receive traffic.

## Request body

- RegisterContainerRequest — Request model for container registration. Called by agent container on startup to register its ACP URL. Includes a registration token for security (CVE-2026-0001 fix).
  - `acp_url` string, required — ACP server URL (e.g., 'http://agent-main-abc123.agents.svc.cluster.local:8000')
  - `branch_id` string, required — Branch ID
  - `registration_token` string, nullable — Single-use registration token provided during deployment (required when configured)
  - `version_id` string, required — Version ID being registered

## Response `200`

Successful Response

- RegisterContainerResponse — Response from container registration.
  - `agent_api_key` string, required — API key for the agent
  - `agent_id` string, required — Agent ID
  - `agent_name` string, required — Agent name
  - `branch_id` string, required — Branch ID
  - `version_status` 'DEPLOYING' | 'ACTIVE' | 'FAILED' | 'UNHEALTHY' | 'DRAINING' | 'RETIRED' | 'ROLLED_BACK', required — Status of a version in its lifecycle.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/terminaluse/apis/sb0-api.md) · [All operations](https://skmtc.net/terminaluse/apis/sb0-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/terminaluse/sb0-api/revisions/f24a474dc415/schema)