Create Schedule Trigger

POST

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

POST

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

$ curl -X POST https://app.rightbrain.ai/api/v1/org/org_id/project/project_id/trigger/schedule \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/json" \
>      -d '{
>   "name": "nightly-summary",
>   "cron_expression": "0 2 * * *",
>   "target_type": "task",
>   "target_id": "0190a234-8dc6-6d08-aea9-928fcecad8f1",
>   "description": "Runs the summariser every night at 02:00 UTC.",
>   "timezone": "UTC",
>   "task_input": {
>     "text": "Yesterday'\''s support tickets."
>   }
> }'

1 {
2   "id": "019f8a27-6b3d-41ac-9f18-2c7d5e0a9143",
3   "target_type": "task",
4   "target_id": "0190a234-8dc6-6d08-aea9-928fcecad8f1",
5   "name": "nightly-summary",
6   "status": "enabled",
7   "cron_expression": "0 2 * * *",
8   "timezone": "UTC",
9   "created": "2026-07-28T09:14:58.117402Z",
10   "modified": "2026-07-28T09:14:58.117402Z",
11   "created_by_user_id": "0190c234-1111-2222-3333-444444444444",
12   "task_agent_revision_id": null,
13   "trigger_type": "schedule",
14   "description": "Runs the summariser every night at 02:00 UTC.",
15   "task_input": {
16     "text": "Yesterday's support tickets."
17   },
18   "next_run_at": "2026-07-29T02:00:00Z",
19   "last_run_at": null,
20   "expires_at": null
21 }

Create a schedule trigger.

cron_expression is evaluated in timezone, which defaults to UTC. target_type is task or task_agent and target_id is that resource’s id. Set expires_at to stop firing after a date.

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

Request

This endpoint expects an object.

namestringRequired1-63 characters

cron_expressionstringRequired<=255 characters

target_typeenumRequired

Target resource type for trigger execution.

target_idstringRequiredformat: "uuid"

descriptionstring or nullOptional<=255 characters

statusenumOptional

Lifecycle status for triggers.

timezonestringOptional<=63 charactersDefaults to UTC

task_inputmap from strings to any or nullOptional

expires_atdatetime or nullOptional

task_agent_revision_idstring or nullOptionalformat: "uuid"

Response

Schedule trigger created successfully

idstringformat: "uuid"

target_typeenum

Target resource type for trigger execution.

target_idstringformat: "uuid"

namestring

statusenum

Lifecycle status for triggers.

cron_expressionstring

timezonestring

createdstring

modifiedstring

created_by_user_idstringformat: "uuid"

task_agent_revision_idstring or nullformat: "uuid"

trigger_type"schedule"Defaults to schedule

descriptionstring or null

task_inputmap from strings to any or null

next_run_atstring or null

last_run_atstring or null

expires_atstring 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