For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
DashboardWebsiteCommunity
DocsAPI ReferenceChangelog
DocsAPI ReferenceChangelog
  • API Reference
      • GETList Tasks
      • POSTCreate a New Task
      • GETGet Task Details
      • POSTUpdate a Task
      • DELDelete Task
      • GETFetch Token Report
      • GETFetch Usage Report
      • GETFetch Timing Report
      • GETFetch Credit Report
      • GETList Task Runs
      • POSTRun Task
      • GETIAM - List Task Members
      • GETIAM - Lookup Task Member
      • POSTIAM - Update Task Member
      • POSTIAM - Test Task Permissions
      • GETFetch a user submitted file (image or audio) for a given Task Run
      • GETFetch a Task Run
      • GETList Project Task Runs
      • GETList Project Recent Task Runs By Task
      • GETGet Project Task Timing Report
      • GETGet Project Task Usage Report
      • GETList Project Task Shares
      • GETList Task Shares
      • POSTCreate Task Share
      • DELRevoke Task Share
      • POSTClone Shared Task
  • External Links
    • Agent API Docs
    • OpenAPI Spec
LogoLogo
DashboardWebsiteCommunity
API ReferenceTasks

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

Create a New Task

Next
Built with

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

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

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