List Triggers

GET

/org/:org_id/project/:project_id/trigger

GET

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

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

1 [
2   {
3     "trigger_type": "webhook",
4     "auth_method": "hmac_sha256",
5     "created": "2026-07-28T09:15:22.481203Z",
6     "id": "019f8a25-4a1b-41ac-8f07-1b6c4d9e8032",
7     "name": "helpdesk-inbound",
8     "status": "enabled",
9     "target_id": "0190a234-8dc6-6d08-aea9-928fcecad8f1",
10     "target_type": "task",
11     "description": "Fires the summariser when the helpdesk posts a ticket.",
12     "task_agent_revision_id": null
13   },
14   {
15     "trigger_type": "schedule",
16     "created": "2026-07-28T09:14:58.117402Z",
17     "cron_expression": "0 2 * * *",
18     "id": "019f8a27-6b3d-41ac-9f18-2c7d5e0a9143",
19     "name": "nightly-summary",
20     "status": "enabled",
21     "target_id": "0190a234-8dc6-6d08-aea9-928fcecad8f1",
22     "target_type": "task",
23     "timezone": "UTC",
24     "description": "Runs the summariser every night at 02:00 UTC.",
25     "expires_at": null,
26     "next_run_at": "2026-07-29T02:00:00Z",
27     "task_agent_revision_id": null
28   }
29 ]

List every trigger in the project, of any kind.

Filter with trigger_type (webhook, schedule, gmail_inbox) and target_type (task, task_agent).

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 organization ID

project_idstringRequiredformat: "uuid"

The project ID

Query parameters

limitintegerOptional1-100Defaults to 100

Maximum number of triggers to return.

cursorstring or nullOptionalformat: "uuid"

Return only triggers whose id is below this value. Pass the id of the last trigger from the previous page.

trigger_typeenum or nullOptional

Return only triggers of this kind: webhook, schedule or gmail_inbox.

Allowed values:

target_typeenum or nullOptional

Return only triggers whose target is a task or a task_agent. Required when target_id is supplied.

Allowed values:

target_idstring or nullOptionalformat: "uuid"

Return only triggers firing this Task or TaskAgent id. Supplying it without target_type answers 400.

Response

Triggers in the project, of every kind

webhookobject

List item for webhook triggers.

scheduleobject

gmail_inboxobject

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

422

Unprocessable Entity Error

500

Internal Server Error