List Task Agent Revisions

GET

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

GET

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

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

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

List immutable executable revisions for a Task Agent.

Each revision contains the runtime configuration and pinned attachments that can be executed by new runs, long-lived sessions, or pinned triggers. The active revision is marked with active.

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

Response

Task Agent revisions

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