Create Task Agent Run Support Request

POST

/org/:org_id/project/:project_id/task-agent/:task_agent_id/support-request

POST

/api/v1/org/:org_id/project/:project_id/task-agent/:task_agent_id/support-request

$ curl -X POST https://app.rightbrain.ai/api/v1/org/org_id/project/project_id/task-agent/task_agent_id/support-request \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/json" \
>      -d '{
>   "run_ids": [
>     "019fa2da-4790-712c-aaa2-cb8d287b620b"
>   ],
>   "annotation": "Reply referenced the wrong account name for a Northfield Joinery ticket — can support check why the lookup matched the wrong row?"
> }'

1 {
2   "id": "019fa2e2-2f00-738f-ad3d-25fa857b319b",
3   "org_id": "0190a234-5678-9abc-def0-123456789abc",
4   "project_id": "0190a234-9876-5432-10ab-cdef01234567",
5   "requested_by_user_id": "0190c234-1111-2222-3333-444444444444",
6   "status": "open",
7   "created": "2026-07-27T09:30:00Z",
8   "annotation": "Reply referenced the wrong account name for a Northfield Joinery ticket — can support check why the lookup matched the wrong row?",
9   "modified": "2026-07-27T09:30:00Z",
10   "snapshot_entries": [
11     {
12       "id": "019fa2e2-2f00-720e-8894-970f64e46fb3",
13       "task_agent_run_id": "019fa2da-4790-712c-aaa2-cb8d287b620b",
14       "snapshot_schema_version": 1,
15       "payload_created_at": "2026-07-27T09:30:00Z",
16       "created": "2026-07-27T09:30:00Z",
17       "expires_at": "2026-08-26T09:30:00Z",
18       "modified": "2026-07-27T09:30:00Z"
19     }
20   ]
21 }

Request support for one or more visible Task Agent runs. The request stores metadata plus a redacted diagnostic snapshot for each listed run. The response returns metadata only and never includes the support payload.

Authentication

AuthorizationBearer

API key or access token, sent as Authorization: Bearer <token>. The simplest option: create an API key in your dashboard under Settings, then paste it here.

AuthorizationBearer

API key or access token, sent as Authorization: Bearer <token>. The simplest option: create an API key in your dashboard under Settings, then paste it here.

Path parameters

org_idstringRequiredformat: "uuid"

The organization ID

project_idstringRequiredformat: "uuid"

The project ID

task_agent_idstringRequiredformat: "uuid"

The task agent ID

Request

This endpoint expects an object.

run_idslist of stringsRequired

annotationstring or nullOptional<=4000 characters

Response

Support request created

idstringformat: "uuid"

org_idstringformat: "uuid"

project_idstringformat: "uuid"

requested_by_user_idstring or nullformat: "uuid"

statusenum or string

createdstring

annotationstring or nullOptional

payload_redacted_atstring or nullOptional

payload_redacted_by_user_idstring or nullOptionalformat: "uuid"

redaction_reasonstring or nullOptional

modifiedstring or nullOptional

snapshot_entrieslist of objectsOptional

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

422

Unprocessable Entity Error

500

Internal Server Error