Update Schedule Trigger

POST

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

POST

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

$ curl -X POST https://app.rightbrain.ai/api/v1/org/org_id/project/project_id/trigger/schedule/trigger_id \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/json" \
>      -d '{
>   "description": "Runs the summariser every night at 03:00 UTC.",
>   "status": "disabled",
>   "cron_expression": "0 3 * * *"
> }'

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": "disabled",
7   "cron_expression": "0 3 * * *",
8   "timezone": "UTC",
9   "created": "2026-07-28T09:14:58.117402Z",
10   "modified": "2026-07-28T09:18:11.640925Z",
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 03: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 }

Update a schedule trigger’s cadence, payload or status.

status accepts draft, disabled or enabled — a disabled trigger keeps its configuration but stops firing.

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

trigger_idstringRequiredformat: "uuid"

Request

This endpoint expects an object.

namestring or nullOptional1-63 characters

descriptionstring or nullOptional<=255 characters

statusenum or nullOptional

Lifecycle status for triggers.

cron_expressionstring or nullOptional<=255 characters

timezonestring or nullOptional<=63 characters

task_inputmap from strings to any or nullOptional

expires_atdatetime or nullOptional

task_agent_revision_idstring or nullOptionalformat: "uuid"

Response

Schedule trigger updated 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