iAdvizeDocs

Get a version

Returns a single configuration version. A 404 unless the version exists and belongs to the agent in the path.

GET
/api/v1/sites/{siteId}/agents/{id}/versions/{versionId}

Authorization

ApiKeyAuth
AuthorizationBearer <token>

A WorkOS org-scoped API key, created from the dashboard's organization settings page. Identifies the tenant every read and write is scoped to. Missing, malformed, unknown, revoked, expired, or non-organization-owned keys all return 401 (no distinction, so the response can't be used to probe which keys or org ids exist).

In: header

Path Parameters

siteId*string

The site id (prefixed site_). A site id that isn't yours is a 404, same as any other cross-tenant id.

id*string

The agent id (prefixed agt_).

versionId*string

The configuration version id (prefixed agtv_).

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X GET "https://example.com/api/v1/sites/string/agents/string/versions/string"
{  "data": {    "id": "string",    "agentId": "string",    "version": 0,    "status": "draft",    "engine": "string",    "startersAlignment": "left",    "showStarterQuestions": true,    "avatarUrl": "string",    "createdAt": "2019-08-24T14:15:22Z",    "updatedAt": "2019-08-24T14:15:22Z"  }}

Create a version

Versions are immutable: to change an agent's instructions you create a new version rather than editing one. The new version gets the next per-agent version number. If you create it directly as `champion`, the previous champion is archived automatically.

Change a version's status

Moves a version through its lifecycle. Only the `status` can change here: the instructions are immutable. Promoting a version to `champion` archives the agent's current champion automatically (at most one champion per agent).