Info
Endpoint added: GET /accounts/{}/workers/observability/agents/sessions
openapi:GET /accounts/{}/workers/observability/agents/sessions::operation.endpoint-added- Product
- Cloudflare API
- Source
- Repository Spec
- Change kind
- Endpoint Added
- Detected
- Last updated
Deterministic evidence
Before / after
Extracted from Cloudflare's published contract. Shows the whole operation — a narrower excerpt was not available for this change. Open the source ↗
null
{
"operationId": "agents.sessions.list",
"parameters": [
{
"in": "query",
"name": "service",
"required": true,
"schema": {
"maxLength": 512,
"minLength": 1,
"type": "string"
}
},
{
"in": "query",
"name": "agent",
"required": true,
"schema": {
"maxLength": 512,
"minLength": 1,
"type": "string"
}
},
{
"in": "query",
"name": "from",
"required": true,
"schema": {
"minimum": 0,
"type": "integer"
}
},
{
"in": "query",
"name": "to",
"required": true,
"schema": {
"minimum": 0,
"type": "integer"
}
},
{
"in": "query",
"name": "cursor",
"schema": {
"maxLength": 2048,
"minLength": 1,
"type": "string"
}
},
{
"in": "query",
"name": "per_page",
"schema": {
"maximum": 100,
"minimum": 1,
"type": "integer"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"properties": {
"errors": {
"items": {
"properties": {
"message": {
"type": "string"
}
},
"required": [
"message"
],
"type": "object"
},
"type": "array"
},
"messages": {
"items": {
"properties": {
"message": {
"enum": [
"Successful request"
],
"type": "string"
}
},
"required": [
"message"
],
"type": "object"
},
"type": "array"
},
"result": {
"items": {
"properties": {
"agentId": {
"type": "string"
},
"agentName": {
"type": "string"
},
"conversationId": {
"type": "string"
},
"inputTokens": {
"type": "number"
},
"lastActiveMs": {
"type": "number"
},
"models": {
"items": {
"type": "string"
},
"type": "array"
},
"outputTokens": {
"type": "number"
},
"providers": {
"items": {
"type": "string"
},
"type": "array"
},
"serviceName": {
"type": "string"
},
"sessionDurationMs": {
"type": "number"
},
"sessionStartMs": {
"type": "number"
},
"spanCount": {
"type": "number"
},
"status": {
"enum": [
"observed_no_error",
"error"
],
"type": "string"
},
"traceCount": {
"type": "number"
}
},
"required": [
"conversationId",
"serviceName",
"agentName",
"sessionStartMs",
"lastActiveMs",
"sessionDurationMs",
"traceCount",
"spanCount",
"status",
"models",
"providers"
],
"type": "object"
},
"type": "array"
},
"result_info": {
"properties": {
"count": {
"minimum": 0,
"type": "integer"
},
"cursors": {
"properties": {
"after": {
"nullable": true,
"type": "string"
}
},
"required": [
"after"
],
"type": "object"
},
"per_page": {
"minimum": 1,
"type": "integer"
}
},
"required": [
"per_page",
"count",
"cursors"
],
"type": "object"
},
"success": {
"enum": [
true
],
"type": "boolean"
}
},
"required": [
"messages",
"success",
"errors",
"result",
"result_info"
],
"type": "object"
}
}
}
},
"400": {
"content": {
"application/json": {
"schema": {
"properties": {
"errors": {
"items": {
"properties": {
"detail": {
"type": "string"
},
"message": {
"enum": [
"Bad Request"
],
"type": "string"
}
},
"required": [
"message"
],
"type": "object"
},
"type": "array"
},
"messages": {
"items": {
"properties": {
"message": {
"type": "string"
}
},
"required": [
"message"
],
"type": "object"
},
"type": "array"
},
"success": {
"enum": [
false
],
"type": "boolean"
}
},
"required": [
"errors",
"success",
"messages"
],
"type": "object"
}
}
}
},
"401": {
"content": {
"application/json": {
"schema": {
"properties": {
"errors": {
"items": {
"properties": {
"detail": {
"type": "string"
},
"message": {
"enum": [
"Unauthorized"
],
"type": "string"
}
},
"required": [
"message"
],
"type": "object"
},
"type": "array"
},
"messages": {
"items": {
"properties": {
"message": {
"type": "string"
}
},
"required": [
"message"
],
"type": "object"
},
"type": "array"
},
"success": {
"enum": [
false
],
"type": "boolean"
}
},
"required": [
"errors",
"success",
"messages"
],
"type": "object"
}
}
}
},
"403": {
"content": {
"application/json": {
"schema": {
"properties": {
"errors": {
"items": {
"properties": {
"detail": {
"type": "string"
},
"message": {
"enum": [
"Forbidden"
],
"type": "string"
}
},
"required": [
"message"
],
"type": "object"
},
"type": "array"
},
"messages": {
"items": {
"properties": {
"message": {
"type": "string"
}
},
"required": [
"message"
],
"type": "object"
},
"type": "array"
},
"success": {
"enum": [
false
],
"type": "boolean"
}
},
"required": [
"errors",
"success",
"messages"
],
"type": "object"
}
}
}
},
"429": {
"content": {
"application/json": {
"schema": {
"properties": {
"errors": {
"items": {
"properties": {
"detail": {
"type": "string"
},
"message": {
"enum": [
"Too many requests"
],
"type": "string"
}
},
"required": [
"message"
],
"type": "object"
},
"type": "array"
},
"messages": {
"items": {
"properties": {
"message": {
"type": "string"
}
},
"required": [
"message"
],
"type": "object"
},
"type": "array"
},
"success": {
"enum": [
false
],
"type": "boolean"
}
},
"required": [
"errors",
"success",
"messages"
],
"type": "object"
}
}
}
},
"500": {
"content": {
"application/json": {
"schema": {
"properties": {
"errors": {
"items": {
"properties": {
"detail": {
"type": "string"
},
"message": {
"enum": [
"Internal error"
],
"type": "string"
}
},
"required": [
"message"
],
"type": "object"
},
"type": "array"
},
"messages": {
"items": {
"properties": {
"message": {
"type": "string"
}
},
"required": [
"message"
],
"type": "object"
},
"type": "array"
},
"success": {
"enum": [
false
],
"type": "boolean"
}
},
"required": [
"errors",
"success",
"messages"
],
"type": "object"
}
}
}
},
"504": {
"content": {
"application/json": {
"schema": {
"properties": {
"errors": {
"items": {
"properties": {
"detail": {
"type": "string"
},
"message": {
"enum": [
"Gateway timeout"
],
"type": "string"
}
},
"required": [
"message"
],
"type": "object"
},
"type": "array"
},
"messages": {
"items": {
"properties": {
"message": {
"type": "string"
}
},
"required": [
"message"
],
"type": "object"
},
"type": "array"
},
"success": {
"enum": [
false
],
"type": "boolean"
}
},
"required": [
"errors",
"success",
"messages"
],
"type": "object"
}
}
}
}
},
"tags": [
"Agents"
],
"x-api-token-group": [
"Workers Observability Write",
"Workers Observability Read"
],
"x-fern-availability": "beta",
"x-fern-sdk-group-name": "observability.agents.sessions",
"x-fern-sdk-method-name": "list",
"x-forge-aliases": [
{
"x-fern-sdk-group-name": "o11y.agents.sessions",
"x-fern-sdk-method-name": "list"
}
]
}
Monitored for you
Does this change affect your integration?
Choose the operations and fields your services use. detektu matches Cloudflare findings to that declared usage so your team can review the relevant evidence. No agent or repository access required.