Skip to content
UltimateTeam.ai Docs

Get Delegation Links

GET
/api/v1/accountability/delegations/{task_id}/links
curl --request GET \
  --url https://api.ultimateteam.ai/api/v1/accountability/delegations/example/links \
  --header 'X-API-Key: <X-API-Key>'

Get all delegation links where the given task is the child.

Shows who delegated to this task and what was requested.

Args: task_id: The child task ID to look up. user: The authenticated user context. svc: The delegation chain service (injected).

Returns: List of delegation chain link responses.

Authorizations

Section titled “Authorizations”

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters”
task_id
required
Task Id
string

Responses

Section titled “ Responses ”

200

Section titled “200”

Successful Response

Media typeapplication/json
Response Get Delegation Links Api V1 Accountability Delegations Task Id Links Get
Array<object>
DelegationChainLinkResponse

Response schema for a persisted delegation chain link.

Attributes: id: Unique link identifier. tenant_id: Owning tenant UUID. parent_task_id: Task ID of the delegating parent (None for root). child_task_id: Task ID of the delegated-to child task. delegator_role: Agent role that delegated. delegate_role: Agent role that received delegation. request_summary: Description of what was requested. response_summary: Description of what was delivered. depth: Chain depth (root = 1). context_id: A2A context for grouping. workflow_run_id: Optional FK to workflow_runs.id. status: Link status. created_at: When the delegation was created. completed_at: When the delegation completed or failed.

object
child_task_id
required
Child Task Id
string
completed_at
required
Any of:
string format: date-time
context_id
required
Any of:
string
created_at
required
Created At
string format: date-time
delegate_role
required
Delegate Role
string
delegator_role
required
Delegator Role
string
depth
required
Depth
integer
id
required
Id
string format: uuid
parent_task_id
required
Any of:
string
request_summary
required
Request Summary
string
response_summary
required
Any of:
string
status
required
Status
string
tenant_id
required
Tenant Id
string format: uuid
workflow_run_id
required
Any of:
string format: uuid
Examplegenerated
[
  {
    "child_task_id": "example",
    "completed_at": "2026-04-15T12:00:00Z",
    "context_id": "example",
    "created_at": "2026-04-15T12:00:00Z",
    "delegate_role": "example",
    "delegator_role": "example",
    "depth": 1,
    "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
    "parent_task_id": "example",
    "request_summary": "example",
    "response_summary": "example",
    "status": "example",
    "tenant_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
    "workflow_run_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0"
  }
]

422

Section titled “422”

Validation Error

Media typeapplication/json
HTTPValidationError
object
detail
Detail
Array<object>
ValidationError
object
ctx
Context
object
input
Input
loc
required
Location
Array
msg
required
Message
string
type
required
Error Type
string
Examplegenerated
{
  "detail": [
    {
      "ctx": {},
      "input": "example",
      "loc": [
        "example"
      ],
      "msg": "example",
      "type": "example"
    }
  ]
}