List Tasks

GET

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

GET

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

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

1 {
2   "results": [
3     {
4       "active": true,
5       "created_at": "2024-01-16T13:33:25.247662Z",
6       "description": "Summarizes long text",
7       "id": "0190a234-8dc6-6d08-aea9-928fcecad8f1",
8       "input_params": [
9         {
10           "description": "Text to summarize",
11           "name": "text"
12         }
13       ],
14       "llm_model": "ec217e75-72ea-4281-a1b8-cb7bd0ef9f41",
15       "mcp_servers": [],
16       "metadata": {},
17       "name": "Text Summarizer",
18       "organization_id": "0190a234-5678-9abc-def0-123456789abc",
19       "output_format": [
20         {
21           "description": "Brief summary of the text",
22           "name": "summary",
23           "type": "string"
24         },
25         {
26           "description": "List of key points",
27           "name": "key_points",
28           "type": "array"
29         }
30       ],
31       "output_format_type": "json",
32       "project_id": "0190a234-9876-5432-10ab-cdef01234567",
33       "system_prompt": "You are a helpful assistant that creates concise summaries.",
34       "task_revision_id": "0190a234-8dc7-1234-aea9-928fcecad8f2",
35       "updated_at": "2024-01-16T14:22:11.123456Z",
36       "user_prompt": "Please summarize the following text: {{text}}",
37       "vision_enabled": false
38     },
39     {
40       "active": true,
41       "created_at": "2024-01-10T08:00:00Z",
42       "description": "Analyzes customer messages and provides structured responses",
43       "enabled": true,
44       "exposed_to_agents": false,
45       "file_input_mode": "none",
46       "id": "0190a234-8dc6-6d08-aea9-928fcecad8f2",
47       "input_params": [
48         {
49           "description": "Customer message to analyze",
50           "name": "message"
51         }
52       ],
53       "llm_model": "ec217e75-72ea-4281-a1b8-cb7bd0ef9f41",
54       "mcp_servers": [],
55       "metadata": {
56         "department": "support",
57         "version": "1.2"
58       },
59       "name": "Customer Support Analyzer",
60       "organization_id": "0190a234-5678-9abc-def0-123456789abc",
61       "output_format": [
62         {
63           "description": "Customer sentiment",
64           "name": "sentiment",
65           "type": "string"
66         },
67         {
68           "description": "Issue category",
69           "name": "category",
70           "type": "string"
71         },
72         {
73           "description": "Suggested response to customer",
74           "name": "suggested_response",
75           "type": "string"
76         }
77       ],
78       "output_format_type": "json",
79       "output_modality": "json",
80       "project_id": "0190a234-9876-5432-10ab-cdef01234567",
81       "public": false,
82       "system_prompt": "You are a helpful customer support assistant.",
83       "task_revision_id": "0190a234-8dc7-5678-aea9-928fcecad8f3",
84       "updated_at": "2024-01-15T14:30:00Z",
85       "user_prompt": "Analyze this customer message: {{message}}\nProvide sentiment and suggested response.",
86       "vision_enabled": false
87     }
88   ],
89   "pagination": {
90     "has_next": true,
91     "page_limit": 25,
92     "next_cursor": "0190a234-8dc6-6d08-aea9-928fcecad8f2"
93   }
94 }

List all Tasks in the project with pagination support.

Returns a paginated list of Tasks with their basic information:

Task ID and metadata
Active revision status
Latest modification time
Tags

Use the page_limit and cursor parameters to navigate through the results.

List all Tasks in the project with pagination support. Returns a paginated list of Tasks with their basic information: - Task ID and metadata - Active revision status - Latest modification time - Tags Use the page_limit and cursor parameters to navigate through the results.

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.

Query parameters

namestringOptional

Filter tasks by name (case-insensitive partial match).

tag_idstringOptionalformat: "uuid"

Filter tasks by tag ID.

created_by_mebooleanOptionalDefaults to false

Filter tasks to those created by the current user.

include_testsbooleanOptionalDefaults to false

Include test revisions

cursorstringOptional

Pagination cursor for the next page of results.

page_limitintegerOptional1-100Defaults to 100

Maximum number of tasks to return per page.

Response

Successfully retrieved paginated tasks

resultslist of objects

The task results for this page

paginationobject

Pagination metadata

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

422

Unprocessable Entity Error

500

Internal Server Error