Agent Versions

List agent versions

GET /agents/{agent_name}/versions

Returns a paged collection of versions for the specified agent.

Parámetros de la ruta de acceso

agent_name string requerido

The name of the agent to retrieve versions for.

Parámetros de consulta

limit integer

A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 20.

order enum

Sort order by the created_at timestamp of the objects. asc for ascending order anddesc for descending order.

ascdesc

after string

A cursor for use in pagination. after is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include after=obj_foo in order to fetch the next page of the list.

before string

A cursor for use in pagination. before is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include before=obj_foo in order to fetch the previous page of the list.

include_drafts boolean

(Preview) Whether to include draft versions in the listing. The service defaults to false if a value is not specified by the caller (only non-draft versions are returned).

api-version string requerido

The API version to use for this operation.

Parámetros de encabezado

Foundry-Features enum

A feature flag opt-in required when using preview operations or modifying persisted preview resources.

DraftAgents=V1Preview

Respuestas

The request has succeeded.

Cuerpo

Content-Type: application/json

data AgentVersionObject[] requerido

The requested list of items.

first_id string

The first ID represented in this list.

last_id string

The last ID represented in this list.

has_more boolean requerido

A value indicating whether there are additional values available not captured in this list.