List Task Agents

GET

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

GET

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

$ curl https://app.rightbrain.ai/api/v1/org/123e4567-e89b-12d3-a456-426614174000/project/123e4567-e89b-12d3-a456-426614174001/task-agent \
>      -H "Authorization: Bearer <token>"

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

List all Task Agents configured for the project. Returns a paginated list of Task Agents with their root metadata and embedded revision history. Runtime configuration such as instructions, models, and tools is stored on each revision.

Authentication

AuthorizationBearer

Bearer token authentication using JWT tokens from Ory Kratos/Hydra

Path parameters

org_idstringRequiredformat: "uuid"

The unique identifier of the organization.

project_idstringRequiredformat: "uuid"

The unique identifier of the project.

Query parameters

cursorstringOptional

Pagination cursor

page_limitintegerOptional1-100Defaults to 100

Max results per page

Response

Successfully retrieved Task Agents

resultslist of objects

The list of items returned for the current page.

paginationobject or null

Contains pagination information for the result set.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

422

Unprocessable Entity Error

500

Internal Server Error