Get agent

GET

https://api.astropod.ai/api/v1/agents/:account/:name

GET

/api/v1/agents/:account/:name

1 curl https://api.astropod.ai/api/v1/agents/account/name \
2      -H "Authorization: Bearer <token>" \
3      -H "Content-Type: application/json"

1 {
2   "account": "stellartech",
3   "name": "astro-navigator",
4   "registry": "docker.io/stellartech/astro-navigator",
5   "versions": [
6     {
7       "build_id": "bld-20240612-xyz123",
8       "version": "1.4.2",
9       "spec": {
10         "entrypoint": "main.py",
11         "language": "python",
12         "dependencies": [
13           "numpy>=1.21.0",
14           "requests>=2.25.1"
15         ],
16         "resources": {
17           "cpu": "500m",
18           "memory": "256Mi"
19         }
20       },
21       "readme": "Astro Navigator is an AI agent designed to assist with space mission planning and trajectory optimization.",
22       "published_at": "2024-01-15T09:30:00Z",
23       "validation_warnings": [
24         {
25           "warning": "Deprecated API usage in spec",
26           "field": "dependencies"
27         }
28       ]
29     }
30   ]
31 }

Returns an agent by account and name. Public callers see only published versions; authenticated account members see all builds and semver annotations.

Authentication

AuthorizationBearer

OAuth 2.0 device flow or session token from WorkOS

Path parameters

accountstringRequired

Account name (slug)

namestringRequired

Agent name

Response

Agent details with versions

accountstring or null

namestring or null

registrystring or null

versionslist of objects or null

Authentication

Path parameters

Response

Errors