Gets a paginated list of agent instances for a given agent version
GET/api/v2/AgentInstance/:agentCode/:agentVersion
Gets a paginated list of agent instances for a given agent version
Request
Path Parameters
The unique code identifying the agent.
Optional agent version to filter by.
Query Parameters
Optional user identifier to filter by.
Optional group identifier to filter by.
Optional search term to filter by name.
Default value: desc
Sort direction by start date: "asc" or "desc". Default is "desc".
Default value: 1
The page number to retrieve. Default is 1.
Default value: 20
The number of items per page. Default is 20.
Use this param to override the culture of the response. Options: - en (default) - es
Responses
- 200
- 401
- 403
- 404
- 500
OK
- text/plain
- application/json
- text/json
- Schema
- Example (from schema)
Schema
Array [
Array [
]
]
Array [
]
items
object[]
nullable
links
object[]
nullable
usage
object
costs
object
links
object[]
nullable
{
"items": [
{
"links": [
{
"method": "string",
"url": "string",
"rel": "string"
}
],
"id": "string",
"name": "string",
"agentVersion": 0,
"startDate": "2024-07-29T15:51:28.071Z",
"endDate": "2024-07-29T15:51:28.071Z",
"timeToFirstToken": 0,
"channel": "string",
"userIdentifier": "string",
"groupIdentifier": "string",
"ipAddress": "string",
"userAgent": "string",
"usage": {
"promptTokens": 0,
"completionTokens": 0,
"totalTokens": 0
},
"costs": {
"prompt": 0,
"completion": 0,
"services": 0,
"total": 0,
"currency": "string"
}
}
],
"total": 0,
"pageSize": 0,
"page": 0,
"links": [
{
"method": "string",
"url": "string",
"rel": "string"
}
]
}
- Schema
- Example (from schema)
Schema
Array [
Array [
]
]
Array [
]
items
object[]
nullable
links
object[]
nullable
usage
object
costs
object
links
object[]
nullable
{
"items": [
{
"links": [
{
"method": "string",
"url": "string",
"rel": "string"
}
],
"id": "string",
"name": "string",
"agentVersion": 0,
"startDate": "2024-07-29T15:51:28.071Z",
"endDate": "2024-07-29T15:51:28.071Z",
"timeToFirstToken": 0,
"channel": "string",
"userIdentifier": "string",
"groupIdentifier": "string",
"ipAddress": "string",
"userAgent": "string",
"usage": {
"promptTokens": 0,
"completionTokens": 0,
"totalTokens": 0
},
"costs": {
"prompt": 0,
"completion": 0,
"services": 0,
"total": 0,
"currency": "string"
}
}
],
"total": 0,
"pageSize": 0,
"page": 0,
"links": [
{
"method": "string",
"url": "string",
"rel": "string"
}
]
}
- Schema
- Example (from schema)
Schema
Array [
Array [
]
]
Array [
]
items
object[]
nullable
links
object[]
nullable
usage
object
costs
object
links
object[]
nullable
{
"items": [
{
"links": [
{
"method": "string",
"url": "string",
"rel": "string"
}
],
"id": "string",
"name": "string",
"agentVersion": 0,
"startDate": "2024-07-29T15:51:28.071Z",
"endDate": "2024-07-29T15:51:28.071Z",
"timeToFirstToken": 0,
"channel": "string",
"userIdentifier": "string",
"groupIdentifier": "string",
"ipAddress": "string",
"userAgent": "string",
"usage": {
"promptTokens": 0,
"completionTokens": 0,
"totalTokens": 0
},
"costs": {
"prompt": 0,
"completion": 0,
"services": 0,
"total": 0,
"currency": "string"
}
}
],
"total": 0,
"pageSize": 0,
"page": 0,
"links": [
{
"method": "string",
"url": "string",
"rel": "string"
}
]
}
The user is unauthorized or the session expired
The user does not have permission
The entity was not found
There was an unexpected error