Get Task Details

GET

/org/:org_id/project/:project_id/task/:task_id

GET

/api/v1/org/:org_id/project/:project_id/task/:task_id

$ curl https://app.rightbrain.ai/api/v1/org/org_id/project/project_id/task/task_id \
>      -H "Authorization: Bearer <token>"

1 {
2   "name": "Support Ticket Triage",
3   "enabled": true,
4   "id": "019f8a00-1c3d-7e42-b8f1-2a5c9d4e7b60",
5   "project_id": "019f6b10-2e8a-7c91-9a3d-6e0f8b2c1d47",
6   "created": "2026-07-20T09:14:32Z",
7   "access_token": "TASK_ACCESS_TOKEN_REDACTED",
8   "active_revisions": [
9     {
10       "task_revision_id": "019f8a01-4b3d-7e52-9c02-3b6d8f1a5c71",
11       "weight": 1
12     }
13   ],
14   "description": "Classifies inbound support tickets by category and priority, and drafts a one-line summary for the on-call agent.",
15   "public": false,
16   "exposed_to_agents": true,
17   "output_modality": "json",
18   "task_run_visibility": "editors_and_owners",
19   "modified": "2026-07-25T16:20:05Z",
20   "revisions": [
21     {
22       "system_prompt": "You are a support triage assistant for a B2B SaaS helpdesk. Read each ticket and classify it accurately so it reaches the right team quickly.",
23       "user_prompt": "Ticket subject: {{subject}}\n\nTicket body: {{body}}\n\nCustomer plan: {{plan}}",
24       "llm_model_id": "019f6a00-9e3d-7c42-8f1a-2a5c9d4e7b01",
25       "id": "019f8a01-4b3d-7e52-9c02-3b6d8f1a5c71",
26       "created": "2026-07-20T09:14:32Z",
27       "modified": "2026-07-20T09:14:32Z",
28       "llm_model": {
29         "provider": "Anthropic",
30         "vendor": "anthropic",
31         "name": "claude-sonnet-5",
32         "alias": "Claude Sonnet 5",
33         "description": "Balanced reasoning and speed for structured classification and extraction tasks.",
34         "supports_vision": false,
35         "max_context_window": 200000,
36         "id": "019f6a00-9e3d-7c42-8f1a-2a5c9d4e7b01",
37         "supports_image_output": false,
38         "supports_pdf_vision": false,
39         "supports_tool_calling": true,
40         "supports_context_caching": true,
41         "model_params": {
42           "temperature": {
43             "default": 0.3,
44             "description": "Controls randomness in the output. Lower values make output more focused and deterministic.",
45             "maximum": 1,
46             "minimum": 0,
47             "type": "number"
48           }
49         },
50         "created": "2026-01-05T00:00:00Z",
51         "modified": "2026-01-05T00:00:00Z",
52         "llm_model_comments": []
53       },
54       "input_params": [
55         "subject",
56         "body",
57         "plan"
58       ],
59       "llm_config": {
60         "temperature": 0.2
61       },
62       "output_format": {
63         "category": {
64           "description": "The team best suited to handle this ticket",
65           "options": [
66             "account",
67             "billing",
68             "feature_request",
69             "technical"
70           ],
71           "type": "str"
72         },
73         "priority": {
74           "description": "How urgently the ticket needs a response",
75           "options": [
76             "high",
77             "low",
78             "medium",
79             "urgent"
80           ],
81           "type": "str"
82         },
83         "summary": {
84           "description": "One-sentence summary of the customer's issue",
85           "type": "str"
86         }
87       },
88       "file_input_mode": "none",
89       "optimise_images": true,
90       "test": false,
91       "input_processors": [],
92       "annotation": "Initial production revision",
93       "task_mcp_tool_ids": [],
94       "integration_tool_ids": [],
95       "active": true,
96       "tags": []
97     },
98     {
99       "system_prompt": "You are a support triage assistant for a B2B SaaS helpdesk. Classify each ticket, flag churn risk, and route it to the right team quickly.",
100       "user_prompt": "Ticket subject: {{subject}}\n\nTicket body: {{body}}\n\nCustomer plan: {{plan}}",
101       "llm_model_id": "019f6a00-9e3d-7c42-8f1a-2a5c9d4e7b01",
102       "id": "019f8a06-aa82-7da7-b159-8bb1d36bab06",
103       "created": "2026-07-25T16:20:00Z",
104       "modified": "2026-07-25T16:20:00Z",
105       "llm_model": {
106         "provider": "Anthropic",
107         "vendor": "anthropic",
108         "name": "claude-sonnet-5",
109         "alias": "Claude Sonnet 5",
110         "description": "Balanced reasoning and speed for structured classification and extraction tasks.",
111         "supports_vision": false,
112         "max_context_window": 200000,
113         "id": "019f6a00-9e3d-7c42-8f1a-2a5c9d4e7b01",
114         "supports_image_output": false,
115         "supports_pdf_vision": false,
116         "supports_tool_calling": true,
117         "supports_context_caching": true,
118         "model_params": {
119           "temperature": {
120             "default": 0.3,
121             "description": "Controls randomness in the output. Lower values make output more focused and deterministic.",
122             "maximum": 1,
123             "minimum": 0,
124             "type": "number"
125           }
126         },
127         "created": "2026-01-05T00:00:00Z",
128         "modified": "2026-01-05T00:00:00Z",
129         "llm_model_comments": []
130       },
131       "input_params": [
132         "subject",
133         "body",
134         "plan"
135       ],
136       "llm_config": {
137         "temperature": 0.2
138       },
139       "output_format": {
140         "category": {
141           "description": "The team best suited to handle this ticket",
142           "options": [
143             "account",
144             "billing",
145             "feature_request",
146             "technical"
147           ],
148           "type": "str"
149         },
150         "churn_risk": {
151           "description": "True if the customer shows signs of churn risk",
152           "type": "bool"
153         },
154         "priority": {
155           "description": "How urgently the ticket needs a response",
156           "options": [
157             "high",
158             "low",
159             "medium",
160             "urgent"
161           ],
162           "type": "str"
163         },
164         "summary": {
165           "description": "One-sentence summary of the customer's issue",
166           "type": "str"
167         }
168       },
169       "file_input_mode": "none",
170       "optimise_images": true,
171       "test": false,
172       "input_processors": [],
173       "annotation": "Added churn-risk signal to prioritization",
174       "task_mcp_tool_ids": [],
175       "integration_tool_ids": [],
176       "active": false,
177       "tags": []
178     }
179   ],
180   "tags": [],
181   "shared_with_project": false
182 }

Retrieve detailed information about a specific Task.

Returns the complete Task configuration including:

Basic properties (name, description, enabled status)
All revisions with their prompts and configurations
Currently active revisions and their traffic weights
Associated tags and metadata

Retrieve detailed information about a specific Task. Returns the complete Task configuration including: - Basic properties (name, description, enabled status) - All revisions with their prompts and configurations - Currently active revisions and their traffic weights - Associated tags and metadata

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 unique identifier of the organization.

project_idstringRequiredformat: "uuid"

The unique identifier of the project.

task_idstringRequiredformat: "uuid"

The specific Task to reference.

Query parameters

revision_tag_idstring or nullOptionalformat: "uuid"

Filter task_revisions by tag ID.

include_testsboolean or nullOptionalDefaults to false

Include test revisions

Response

Task details retrieved successfully

namestringformat: "^[a-zA-Z0-9\- ]+$"

A name or reference for the Task.

enabledboolean

When true the Task is active and callable. false denotes the Task is not yet operational.

idstringformat: "uuid"

The unique identifier of the Task.

project_idstringformat: "uuid"

The Project that the Task belongs to.

createdstring

When the Task was created.

access_tokenstring or null

Task specific Bearer token that can be used to authenticated when executing this Task.

active_revisionslist of objects

The revision currently active for this Task.

descriptionstring or nullOptional

A longer description of the Task for internal reference.

publicbooleanOptionalDefaults to false

When true the Task is public and can be accessed by any User.

exposed_to_agentsbooleanOptionalDefaults to false

When true the Task is accessible to agents through the unauthenticated agent endpoint.

output_modalityenumOptional

Specifies the output modality of the task. Can be 'json', 'image', 'audio', 'pdf', 'text', or 'csv'. Defaults to 'json'.

task_run_visibilityenumOptionalDefaults to owner_only

Controls who can view all task runs. ‘owner_only’ - only task owners see all runs (default), ‘editors_and_owners’ - task editors and owners see all runs, ‘all_viewers’ - all users with view permission see all runs.

modifiedstring or nullOptional

When the Task was last updated.

deletedstring or nullOptional

Timestamp when the task was deleted, if applicable.

revisionslist of objectsOptionalDefaults to []

Each update to a Task results in a new Revision being created. Task Revisions are a powerful concept that can be used to assist with A/B testing, comparing responses from different LLM’s, etc.

cloned_from_task_revision_idstring or nullOptionalformat: "uuid"

The unique identifier of the task revision this task was cloned from, if applicable.

tagslist of objectsOptionalDefaults to []

shared_with_projectbooleanOptionalDefaults to false

When true the Task is shared with members of its Project.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

422

Unprocessable Entity Error

500

Internal Server Error