PublicV1PutAgentSegment

PUT

/api/v1/agent-segments/{segmentId}

curl --request PUT \
  --url https://example.com/api/v1/agent-segments/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0 \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "revision": 1, "agentSessionId": "example", "startedAt": "2026-04-15T12:00:00Z", "stoppedAt": "2026-04-15T12:00:00Z", "projectId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "tagIds": [ "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0" ], "description": "example", "working": true, "observedAt": "2026-04-15T12:00:00Z", "final": true, "usageQuality": 0, "usage": [ { "provider": "example", "model": "example", "inputTokens": 1, "outputTokens": 1, "cacheCreationInputTokens": 1, "cacheReadInputTokens": 1 } ], "taskId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0" }'

Authorizations

• bearer

Parameters

Path Parameters

segmentId

required

string format: uuid

Request Body^required

Media typeapplication/json

object

revision

integer format: int64

agentSessionId

string

nullable

startedAt

string format: date-time

stoppedAt

string format: date-time

projectId

string format: uuid

nullable

tagIds

Array<string>

nullable

description

string

nullable

working

boolean

observedAt

string format: date-time

nullable

final

boolean

usageQuality

integer format: int32

Allowed values: 0 1 2

usage

Array<object>

nullable

object

provider

string

nullable

model

string

nullable

inputTokens

integer format: int64

outputTokens

integer format: int64

cacheCreationInputTokens

integer format: int64

cacheReadInputTokens

integer format: int64

taskId

string format: uuid

nullable

Responses

200

OK