Get agent

GET

https://astropods.com/api/v1/agents/:account/:name

GET

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

$ curl https://astropods.com/api/v1/agents/account/name \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/json"

1 {
2   "account": "stellar-innovations",
3   "name": "astro-navigator",
4   "registry": "docker.io/stellar-innovations/astro-navigator",
5   "versions": [
6     {
7       "build_id": "bld-20240601-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         "description": "Agent for autonomous space navigation and telemetry processing."
17       },
18       "readme": "## Astro Navigator\nThis agent processes telemetry data and provides navigation commands for spacecraft.\n\n### Features\n- Real-time data analysis\n- Autonomous decision making\n- Integration with ground control systems",
19       "published_at": "2024-01-15T09:30:00Z",
20       "validation_warnings": [
21         {
22           "warning": "Deprecated API usage in telemetry module",
23           "severity": "low"
24         }
25       ]
26     }
27   ]
28 }

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 platform session token

Path parameters

accountstringRequired

Account name (slug)

namestringRequired

Agent name

Response

Agent details with versions

accountstring

namestring

registrystring

versionslist of objects

Errors

404

Not Found Error