Skip to content
OpenBot

sessions.sessionDelegations

GET
/v1/sessions/{sessionId}/delegations
curl --request GET \
  --url https://example.com/v1/sessions/example/delegations \
  --header 'Authorization: Bearer <token>'

Lists the work that this Session gave to other Agents, with its status and result.

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
sessionId
required
string
>= 1 characters

Responses

Section titled “Responses”

200

Section titled “200”

Success

Media typeapplication/json
Array<object>
object
id
required
string
parent
required
object
session
required
string
turn
required
string
toolCallId
required
string
agent
required
string
>= 1 characters <= 128 characters
child
required
Any of:
object
session
required
string
turn
required
Any of:
string
status
required
string
Allowed values: authorizing queued running completed failed cancelled
brief
required
object
task
required
string
>= 1 characters <= 20000 characters
userRequest
required
string
<= 20000 characters
context
required
Array<string>
references
required
Array<object>
object
session
required
string
item
required
string
constraints
required
Array<string>
expectedOutput
required
string
session
string
result
required
Any of:
object
status
required
string
Allowed values: completed failed cancelled
summary
required
string
artifacts
required
Array<object>
object
kind
required
string
ref
required
string
description
string
openQuestions
required
Array<string>
child
required
object
session
required
string
turn
required
Any of:
string
createdAt
required
number
updatedAt
required
number

Example 

[
  {
    "status": "authorizing",
    "result": {
      "status": "completed"
    }
  }
]

400

Section titled “400”

SessionInvalidRecord | SessionModelInvalid | OrganizationRequired

Media typeapplication/json
Any of:
object
_tag
required
string
Allowed values: SessionInvalidRecord
message
required
string

Example 

{
  "_tag": "SessionInvalidRecord"
}

401

Section titled “401”

AuthenticationRequired

Media typeapplication/json
object
_tag
required
string
Allowed values: AuthenticationRequired

Example 

{
  "_tag": "AuthenticationRequired"
}

403

Section titled “403”

PermissionDenied | MembershipRequired | ForbiddenOrigin

Media typeapplication/json
Any of:
object
_tag
required
string
Allowed values: PermissionDenied
permission
required
string
Allowed values: responses.run sessions.read sessions.write requests.resolve agents.read agents.write agents.delegate connections.read connections.write apps.use apps.publish models.use tokens.read tokens.write organization.read organization.write roles.write model_providers.read model_providers.write sso.read sso.write platform.read platform.write members.read members.write audit_logs.read
resource
required
string

Example 

{
  "_tag": "PermissionDenied",
  "permission": "responses.run"
}

404

Section titled “404”

SessionNotFound

Media typeapplication/json
object
_tag
required
string
Allowed values: SessionNotFound
session
required
string

Example 

{
  "_tag": "SessionNotFound"
}

409

Section titled “409”

SessionBusy | SessionConflict

Media typeapplication/json
Any of:
object
_tag
required
string
Allowed values: SessionBusy
session
required
string

Example 

{
  "_tag": "SessionBusy"
}

503

Section titled “503”

SessionStorageUnavailable | AuthorizationUnavailable | AuthenticationUnavailable

Media typeapplication/json
Any of:
object
_tag
required
string
Allowed values: SessionStorageUnavailable

Example 

{
  "_tag": "SessionStorageUnavailable"
}