API ReferencePublisher Versions

Get an agent version

GET
/v1/publisher/agent-versions/{version_id}

Returns one immutable version owned by the current Workspace.

Authorization

bearerAuth
AuthorizationBearer <token>

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

In: header

Path Parameters

version_id*string

Immutable agent version ID.

Match^aver_[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/agent-versions/string"
{  "id": "aver_01JXYZVERSION02",  "object": "agent.version",  "agent_id": "agent_01JXYZ1234567890",  "number": 2,  "source_revision": 12,  "configuration": {    "name": "Weather Market Forecaster",    "description": "Compares weather forecasts and prediction-market prices.",    "instructions": "Compare current forecasts and explain the strongest position.",    "tools": [      "shell"    ],    "plugins": [      {        "plugin_id": "plugin_research",        "version": "1.4.0"      }    ],    "pricing": {      "minimum_cost_usd": 0.25,      "maximum_cost_usd": 4,      "rates": [        {          "meter": "model_input_tokens",          "price_usd": 0.000002        },        {          "meter": "model_output_tokens",          "price_usd": 0.000004        },        {          "meter": "sandbox_seconds",          "price_usd": 0.01        },        {          "meter": "tool_calls",          "price_usd": 0.01        }      ]    },    "icon_file_id": "file_01JXYZ1234567890",    "categories": [      "weather",      "prediction-markets"    ],    "example_prompts": [      "Compare the latest forecasts for this market."    ]  },  "created_at": "2026-08-30T15:00:00Z"}