Register agent | Astro AI

Registers a new agent build or updates an existing one. Requires account owner or admin role.

AuthorizationBearer

OAuth 2.0 device flow or platform session token

accountstringRequired

Account name (slug)

namestringRequired

Agent name

This endpoint expects an object.

build_idstringRequired

registrystringRequired

OCI registry URL

spec_contentstringRequired

YAML content of astropods.yml

readmestringOptional

Agent registered successfully

messagestring

accountstring

namestring

build_idstring

validation_warningslist of objects

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error

$	curl -X POST https://astropods.com/api/v1/agents/account/name/register \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"build_id": "build-20240615-abc123",
>	"registry": "registry.astropods.com/agents/astro-bot",
>	"spec_content": "name: astro-bot\nversion: 1.2.0\ndescription: AI assistant agent for space data analysis\nentrypoint: main.py\nresources:\n cpu: 500m\n memory: 256Mi\n"
>	}'

1	{
2	"message": "Agent build registered successfully.",
3	"account": "stellar-corp",
4	"name": "astro-bot",
5	"build_id": "build-20240615-abc123",
6	"validation_warnings": []
7	}