Generate an automation draft definition with Workers AI

Requires ADMIN. Returns a draft definition only (never writes journeys/versions, never auto-publishes). 503 when Workers AI binding is absent.

Authorizations

SessionCookie

Parameters

Path Parameters

projectId

required

string

Project (tenant) identifier. Row-level tenant isolation is enforced on every query.

Request Body^required

application/json

object

prompt

required

string

>= 1 characters <= 4000 characters

mode

required

string

Allowed values: create extend

baseDefinition

Journey/automation graph definition. Nodes are typed (trigger/action/branch/wait/waitForEvent/timeWindow).

object

nodes

required

Array<object>

>= 1 items

object

key

additional properties

any

key

additional properties

any

insertAfterNodeId

string

>= 1 characters <= 80 characters

references

object

templateIds

Array<string>

<= 20 items

journeyId

Optional audit linkage for extend mode.

string

>= 1 characters

Responses

200

Generated draft definition with annotated new node IDs.

application/json

object

draftId

string

definition

Journey/automation graph definition. Nodes are typed (trigger/action/branch/wait/waitForEvent/timeWindow).

object

nodes

required

Array<object>

>= 1 items

object

key

additional properties

any

key

additional properties

any

newNodeIds

Array<string>

model

string

warnings

Array<string>

403

Not authenticated (401 via requireAuthenticated) or insufficient project role (403).

application/json

object

error

required

Human-readable error message.

string

message

string

Example^generated

1
{
2
  "error": "example",
3
  "message": "example"
4
}

422

Param validation failed, or generation did not pass validation (error in [invalid_request, generation_invalid]); may include draftId.

application/json

object

error

required

string

message

string

errors

Array<string>

issues

Array<object>

object

key

additional properties

any

draftId

string

key

additional properties

any

Example^generated

1
{
2
  "error": "example",
3
  "message": "example",
4
  "errors": [
5
    "example"
6
  ],
7
  "issues": [
8
    {}
9
  ],
10
  "draftId": "example"
11
}

503

Workers AI unavailable (error=ai_unavailable).

application/json

object

error

required

Human-readable error message.

string

message

string

Example^generated

1
{
2
  "error": "example",
3
  "message": "example"
4
}

POST

/api/projects/{projectId}/automations/ai-draft

1
curl --request POST \
2
  --url https://retidal.com/api/projects/%3Cstring%3E/automations/ai-draft \
3
  --header 'Content-Type: application/json' \
4
  --cookie trackly_session=%3CYOUR_API_KEY%3E \
5
  --data '{
6
  "prompt": "<string>",
7
  "mode": "create",
8
  "baseDefinition": {
9
    "nodes": [
10
      {}
11
    ]
12
  },
13
  "insertAfterNodeId": "<string>",
14
  "references": {
15
    "templateIds": [
16
      "<string>"
17
    ]
18
  },
19
  "journeyId": "<string>"
20
}'

1
const url = 'https://retidal.com/api/projects/%3Cstring%3E/automations/ai-draft';
2
const options = {
3
  method: 'POST',
4
  headers: {
5
    cookie: 'trackly_session=%3CYOUR_API_KEY%3E',
6
    'Content-Type': 'application/json'
7
  },
8
  body: '{"prompt":"<string>","mode":"create","baseDefinition":{"nodes":[{}]},"insertAfterNodeId":"<string>","references":{"templateIds":["<string>"]},"journeyId":"<string>"}'
9
};
10

11
try {
12
  const response = await fetch(url, options);
13
  const data = await response.json();
14
  console.log(data);
15
} catch (error) {
16
  console.error(error);
17
}

1
import requests
2

3
url = "https://retidal.com/api/projects/%3Cstring%3E/automations/ai-draft"
4

5
payload = {
6
    "prompt": "<string>",
7
    "mode": "create",
8
    "baseDefinition": { "nodes": [{}] },
9
    "insertAfterNodeId": "<string>",
10
    "references": { "templateIds": ["<string>"] },
11
    "journeyId": "<string>"
12
}
13
headers = {
14
    "cookie": "trackly_session=%3CYOUR_API_KEY%3E",
15
    "Content-Type": "application/json"
16
}
17

18
response = requests.post(url, json=payload, headers=headers)
19

20
print(response.json())

1
import httpx
2
import json
3

4
url = "https://retidal.com/api/projects/%3Cstring%3E/automations/ai-draft"
5

6
cookies = {"trackly_session": "<YOUR_API_KEY>"}
7

8
payload = json.loads("{\n  \"prompt\": \"<string>\",\n  \"mode\": \"create\",\n  \"baseDefinition\": {\n    \"nodes\": [\n      {}\n    ]\n  },\n  \"insertAfterNodeId\": \"<string>\",\n  \"references\": {\n    \"templateIds\": [\n      \"<string>\"\n    ]\n  },\n  \"journeyId\": \"<string>\"\n}")
9

10
response = httpx.post(url, cookies=cookies, json=payload)
11

12
print(response.json())

1
package main
2

3
import (
4
  "fmt"
5
  "strings"
6
  "net/http"
7
  "io"
8
)
9

10
func main() {
11

12
  url := "https://retidal.com/api/projects/%3Cstring%3E/automations/ai-draft"
13

14
  payload := strings.NewReader("{\n  \"prompt\": \"<string>\",\n  \"mode\": \"create\",\n  \"baseDefinition\": {\n    \"nodes\": [\n      {}\n    ]\n  },\n  \"insertAfterNodeId\": \"<string>\",\n  \"references\": {\n    \"templateIds\": [\n      \"<string>\"\n    ]\n  },\n  \"journeyId\": \"<string>\"\n}")
15

16
  req, _ := http.NewRequest("POST", url, payload)
17

18
  req.Header.Add("cookie", "trackly_session=%3CYOUR_API_KEY%3E")
19
  req.Header.Add("Content-Type", "application/json")
20

21
  res, _ := http.DefaultClient.Do(req)
22

23
  defer res.Body.Close()
24
  body, _ := io.ReadAll(res.Body)
25

26
  fmt.Println(res)
27
  fmt.Println(string(body))
28

29
}

200Generated draft definition with annotated new node IDs.

1
{
2
  "draftId": "example",
3
  "definition": {
4
    "nodes": [
5
      {}
6
    ]
7
  },
8
  "newNodeIds": [
9
    "example"
10
  ],
11
  "model": "example",
12
  "warnings": [
13
    "example"
14
  ]
15
}

Generate an automation draft definition with Workers AI

Authorizations

Parameters

Path Parameters

Request Bodyrequired

Responses

200

403

Examplegenerated

422

Examplegenerated

503

Examplegenerated

Request Body^required

Example^generated

Example^generated

Example^generated