API ReferencePublisher Agents

Get your agent

GET
/v1/publisher/agents/{agent_id}

Returns the agent and its current release state.

Authorization

bearerAuth
AuthorizationBearer <token>

Send a SimpleServe API key as Authorization: Bearer <key>.

In: header

Path Parameters

agent_id*string

Publisher-owned agent ID.

Match^agent_[A-Za-z0-9]+$

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/publisher/agents/string"
{  "id": "agent_01JXYZ1234567890",  "object": "publisher.agent",  "namespace": "northstar",  "slug": "weather-market-forecaster",  "name": "Weather Market Forecaster",  "description": "Compares weather forecasts and prediction-market prices.",  "draft_revision": 12,  "private_deployment": {    "id": "dep_01JXYZPRIVATE01",    "version_id": "aver_01JXYZVERSION01",    "visibility": "private",    "status": "active",    "created_at": "2026-08-30T14:00:00Z",    "activated_at": "2026-08-30T14:00:00Z"  },  "public_deployment": null,  "public_submission": {    "id": "dep_01JXYZPUBLIC001",    "version_id": "aver_01JXYZVERSION02",    "visibility": "public",    "status": "in_review",    "created_at": "2026-08-30T15:00:00Z",    "activated_at": null  },  "created_at": "2026-08-30T13:00:00Z",  "updated_at": "2026-08-30T15:00:00Z"}