Get Task Agent Revision

GET

/org/:org_id/project/:project_id/task-agent/:task_agent_id/revision/:revision_id

GET

/api/v1/org/:org_id/project/:project_id/task-agent/:task_agent_id/revision/:revision_id

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

1 {
2   "id": "string",
3   "task_agent_id": "string",
4   "description": "string",
5   "instruction": "string",
6   "mode": "agentic",
7   "llm_model_id": "string",
8   "fallback_llm_model_id": "string",
9   "created": "string",
10   "llm_model": {
11     "provider": "OpenAI",
12     "vendor": "openai",
13     "name": "gpt-4-turbo-preview",
14     "alias": "GPT-4 Turbo",
15     "description": "Latest GPT-4 model with 128k context window and knowledge cutoff of December 2023.",
16     "supports_vision": true,
17     "max_context_window": 128000,
18     "id": "string",
19     "supports_image_output": false,
20     "supports_pdf_vision": false,
21     "supports_tool_calling": false,
22     "pdf_vision_config": {
23       "max_file_size_mb": 50,
24       "max_pages": 1,
25       "max_visual_pages": 1
26     },
27     "model_params": {},
28     "created": "string",
29     "modified": "string",
30     "replaced_by": "string",
31     "retired": "string",
32     "llm_model_comments": [
33       {
34         "title": "Performance Issue",
35         "description": "Model exhibits inconsistent response quality with complex reasoning tasks.",
36         "id": "string",
37         "llm_model_id": "string",
38         "active": true,
39         "created": "string",
40         "modified": "string"
41       }
42     ]
43   },
44   "fallback_llm_model": {
45     "provider": "OpenAI",
46     "vendor": "openai",
47     "name": "gpt-4-turbo-preview",
48     "alias": "GPT-4 Turbo",
49     "description": "Latest GPT-4 model with 128k context window and knowledge cutoff of December 2023.",
50     "supports_vision": true,
51     "max_context_window": 128000,
52     "id": "string",
53     "supports_image_output": false,
54     "supports_pdf_vision": false,
55     "supports_tool_calling": false,
56     "pdf_vision_config": {
57       "max_file_size_mb": 50,
58       "max_pages": 1,
59       "max_visual_pages": 1
60     },
61     "model_params": {},
62     "created": "string",
63     "modified": "string",
64     "replaced_by": "string",
65     "retired": "string",
66     "llm_model_comments": [
67       {
68         "title": "Performance Issue",
69         "description": "Model exhibits inconsistent response quality with complex reasoning tasks.",
70         "id": "string",
71         "llm_model_id": "string",
72         "active": true,
73         "created": "string",
74         "modified": "string"
75       }
76     ]
77   },
78   "task_tools": [
79     {
80       "id": "string",
81       "task_id": "string",
82       "task_name": "Summarize",
83       "order": 0,
84       "enabled": true,
85       "task_revision_id": "string",
86       "is_output_formatter": false
87     }
88   ],
89   "integrations": [
90     {
91       "id": "string",
92       "project_integration_id": "string",
93       "integration_type": "google_sheets",
94       "integration_name": "string",
95       "order": 1,
96       "enabled": true,
97       "provision_source": "manual",
98       "tool_count": 1,
99       "allowed_tool_ids": [
100         "string"
101       ],
102       "source_skill_id": "string",
103       "source_skill_revision_id": "string",
104       "source_capability_id": "string"
105     }
106   ],
107   "skills": [
108     {
109       "id": "string",
110       "skill_id": "string",
111       "skill_slug": "string",
112       "skill_display_name": "string",
113       "order": 1,
114       "enabled": true,
115       "skill_revision_id": "string"
116     }
117   ],
118   "mcp_servers": [
119     {
120       "id": "string",
121       "task_mcp_server_id": "string",
122       "task_mcp_server_name": "string",
123       "order": 1,
124       "enabled": true,
125       "provision_source": "manual",
126       "tool_count": 1,
127       "allowed_tool_ids": [
128         "string"
129       ],
130       "source_skill_id": "string",
131       "source_skill_revision_id": "string",
132       "source_capability_id": "string"
133     }
134   ],
135   "registered_tools": [
136     {
137       "id": "string",
138       "registered_tool_key": "string",
139       "registered_tool_version": "string",
140       "order": 1,
141       "enabled": true,
142       "provision_source": "manual",
143       "name": "string",
144       "tool_names": [
145         "string"
146       ],
147       "description": "string",
148       "source_skill_id": "string",
149       "source_skill_revision_id": "string",
150       "source_capability_id": "string"
151     }
152   ],
153   "tags": [
154     {
155       "name": "production",
156       "entity_type": "task",
157       "id": "string",
158       "created_at": "string",
159       "is_project_tag": true,
160       "is_global_tag": true,
161       "parent_id": "01909843-3596-da54-4756-28af46917e74",
162       "project_id": "string",
163       "children": [
164         null
165       ],
166       "tagged_entities": [
167         "string"
168       ]
169     }
170   ],
171   "memory_strategy": "string",
172   "memory_config": {},
173   "max_turns": 1,
174   "active": false,
175   "modified": "string"
176 }

Retrieve an immutable executable revision for a Task Agent. The response includes the runtime configuration and concrete pinned attachments stored on that revision.

Authentication

AuthorizationBearer

Bearer token authentication using JWT tokens from Ory Kratos/Hydra

Path parameters

org_idstringRequiredformat: "uuid"

The organization ID

project_idstringRequiredformat: "uuid"

The project ID

task_agent_idstringRequiredformat: "uuid"

The task agent ID

revision_idstringRequiredformat: "uuid"

Response

Task Agent revision

idstringformat: "uuid"

task_agent_idstringformat: "uuid"

descriptionstring or null

instructionstring

modeenum

Execution mode for TaskAgent.

llm_model_idstring or nullformat: "uuid"

fallback_llm_model_idstring or nullformat: "uuid"

createdstring

llm_modelobject or null

fallback_llm_modelobject or null

task_toolslist of objects

integrationslist of objects

skillslist of objects

mcp_serverslist of objects

registered_toolslist of objects

tagslist of objects

memory_strategystring or null

memory_configmap from strings to any or null

max_turnsinteger or null

activebooleanDefaults to false

modifiedstring or null

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

422

Unprocessable Entity Error

500

Internal Server Error