Skip to navigation
Overview

API reference

Astropods REST API for agents and accounts
View as Markdown

The Astropods API lets you list and inspect agents, register and push builds, and retrieve deployment configuration. It is used by the ast CLI and the Astropods dashboard.

Base URL

Requests go to your Astropods server, for example:

https://api.astro.example.com/api/v1

The base URL is set when you run ast login and is stored in your profile.

Authentication

  • Public: GET /agents (list public catalog) and GET /agents/:account/:name (public view of an agent) do not require authentication.
  • Authenticated: All other endpoints require a Bearer token. Use ast login to obtain and store tokens; the CLI sends them automatically.

Send the token in the header:

Authorization: Bearer <your_access_token>

Agents

MethodEndpointDescription
GET/agentsList all agents with at least one published version (public)
GET/agents/:account/:nameGet agent details and versions (public sees published only; account members see all builds)
POST/agents/:account/:name/registerRegister or update an agent build (auth, account owner/admin)
POST/agents/:account/:name/publishPush a build with a semver version (auth, account owner/admin)
GET/agents/:account/:name/configGet required credentials for deploying the latest build (auth)

Profile

MethodEndpointDescription
GET/meGet current user profile and accounts (auth)