Create an automation

POST

https://api.cloudraker.com/organization/automations

POST

/organization/automations

$ curl -X POST https://api.cloudraker.com/organization/automations \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/json" \
>      -d '{
>   "name": "Monday inbox sweep",
>   "prompt": "string",
>   "schedule": {
>     "kind": "string",
>     "expression": "0 9 * * 1-5",
>     "timezone": "Europe/Paris"
>   }
> }'

1 {
2   "automation": {
3     "_id": "string",
4     "name": "string",
5     "kind": "agent_task",
6     "enabled": true,
7     "playbookId": "string",
8     "prompt": "string",
9     "spaceId": "string",
10     "threadPolicy": "reuse",
11     "runAs": "string",
12     "createdBy": "string",
13     "organizationId": "string",
14     "schedule": {
15       "kind": "string",
16       "expression": "0 9 * * 1-5",
17       "timezone": "Europe/Paris"
18     },
19     "nextRunAt": "string",
20     "trigger": {
21       "enabled": true,
22       "secretPreview": "whsec_…9f3a",
23       "secretRotatedAt": "string"
24     },
25     "createdAt": "string",
26     "updatedAt": "string",
27     "runtimeStatus": "idle",
28     "cadence": "string",
29     "triggerRef": "string",
30     "description": "string",
31     "fileIds": [
32       "string"
33     ],
34     "threadId": "string",
35     "lastFiredAt": "string",
36     "lastRunStatus": "started",
37     "lastRunId": "string",
38     "originThreadId": "string"
39   },
40   "secret": "string"
41 }

Creates an agent task: a stored prompt plus a cadence (cron with an IANA timezone, a once instant, or manual for trigger-only). When it fires it drops a message into a real thread you can join, nudge and correct — not a hidden pipeline. Omit spaceId for your own desk; a named space needs space:contribute for you AND for the owner the automation runs as. The inbound trigger secret is returned ONCE, here. Authorization: organization admin.

Creates an agent task: a stored prompt plus a cadence (`cron` with an IANA timezone, a `once` instant, or `manual` for trigger-only). When it fires it drops a message into a real thread you can join, nudge and correct — not a hidden pipeline. Omit `spaceId` for your own desk; a named space needs `space:contribute` for you AND for the owner the automation runs as. The inbound trigger secret is returned ONCE, here. Authorization: organization admin.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.

namestringRequired1-80 characters

promptstringRequired1-4000 characters

The user message injected into the thread when the automation fires.

scheduleobjectRequired

descriptionstringOptional<=400 characters

playbookIdstringOptional1-128 characters

fileIdslist of stringsOptional

spaceIdstringOptional1-128 characters

threadPolicyenumOptionalDefaults to reuse

enabledbooleanOptionalDefaults to true

triggerEnabledbooleanOptionalDefaults to false

originThreadIdstringOptional1-128 characters

Response

The automation and its one-time trigger secret.

automationobject

secretstring

Errors

400

Bad Request Error

403

Forbidden Error

404

Not Found Error