Agent Versioning - Versions

List published versions

Changed on

Deprecated on the v2 branch model. Migrate to GET /agent/{id}/branches/{branchId}/revisions. When ENABLE_BRANCH_MODEL is on, this endpoint returns 409 versioning_v2_migration_required with the Deprecation: true header. See the migration guide.

| List published versions for an agent with pagination and optional pin filter. The total value currently represents the total number of published versions for the agent, not necessarily the filtered count when isPinned is used.

get/agent/{id}/versions

Request

  • Base URL
    https://api.smallest.ai/atoms/v1
  • URL
    https://api.smallest.ai/atoms/v1/agent/{id}/versions
  • Auth
    HTTP bearer

Path parameters

idstring required

The agent ID.

Query parameters

limitinteger

Number of versions to return (1-100, default 20)

skipinteger

Number of versions to skip (default 0)

isPinnedboolean

Filter by pinned status

Response

Successful response

statusboolean

Example response

{
  "status": true
}

Changes

  • 49ce8525306eRevision changes
    • warning

      added the new multi_agents enum value to the /////// response property for the response status

  • a9c928635312Revision changes
    • breaking

      added the pattern ^[a-f\d]{24}$ to the path request parameter id

    • info

      endpoint deprecated

    • info

      added the non-success response with the status