Register agent | Astro AI

import requests
url = "https://api.astropod.ai/api/v1/agents/account/name/register"
payload = {
    "build_id": "build-20240615-xyz123",
    "registry": "registry.astropod.ai/agents/astro-bot",
    "spec_content": "name: AstroBot
version: 1.2.0
description: AI assistant agent for space mission planning
entrypoint: main.py
resources:
  cpu: 500m
  memory: 256Mi
"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())

{
  "message": "Agent build registered successfully.",
  "account": "astroaccount",
  "name": "astro-bot",
  "build_id": "build-20240615-xyz123",
  "validation_warnings": [
    {}
  ]
}

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

Authentication

AuthorizationBearer

OAuth 2.0 device flow or session token from WorkOS

Path parameters

accountstringRequired

Account name (slug)

namestringRequired

Agent name

Request

This endpoint expects an object.

build_idstringRequired

registrystringRequired

OCI registry URL

spec_contentstringRequired

YAML content of astroai.yml

readmestringOptional

Response

Agent registered successfully

messagestring or null

accountstring or null

namestring or null

build_idstring or null

validation_warningslist of objects or null

Authentication

Path parameters

Request

Response

Errors