List Agent Versions

List agent versions, newest first (created_at descending, then id descending). Supplying both before and after returns 422. A before/after id that is not an agent version in this team returns 404.

get/v1/agent-versioning/versions

Request

  • Base URL: https://api.decagon.ai
  • URL: https://api.decagon.ai/v1/agent-versioning/versions
  • Auth: HTTP bearer

Query parameters

limitinteger

Maximum number of items to return, from 1 to 100; defaults to 100. A page may contain fewer items. Use has_more, not page length, to determine whether another page is available.

beforestring nullable

Return the nearest page strictly before this item ID in the endpoint's defined ordering, excluding the referenced item. Use the first returned item's ID to continue backward. Before and after are mutually exclusive; supplying both returns 422. IDs are opaque strings, not encoded cursors or lexical sort boundaries.

afterstring nullable

Return the next page strictly after this item ID in the endpoint's defined ordering, excluding the referenced item. Use the last returned item's ID to continue forward. Before and after are mutually exclusive; supplying both returns 422. Omit both boundaries to request the first page.

has_trafficboolean

When true, return only versions currently serving traffic (percent_traffic > 0). When false or omitted, return all non-archived agent versions.

Response

Successful Response

has_moreboolean

Whether more matching items exist beyond this page in the requested direction: after the last item for forward or initial requests, before the first item for before requests. False for an empty or final page. Keep the same filters and ordering when requesting another page.

Changes

No recorded changes to this operation across all 1 revision of this API.