Create cron trigger

curl --request POST \
  --url https://api.omnara.com/v1/orgs/{orgID}/projects/{projectID}/cron-triggers \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "target": {
    "type": "agent",
    "agent_id": "<string>"
  },
  "cron": "<string>",
  "timezone": "UTC",
  "message_template": "<string>",
  "enabled": true
}
'

import requests

url = "https://api.omnara.com/v1/orgs/{orgID}/projects/{projectID}/cron-triggers"

payload = {
    "name": "<string>",
    "target": {
        "type": "agent",
        "agent_id": "<string>"
    },
    "cron": "<string>",
    "timezone": "UTC",
    "message_template": "<string>",
    "enabled": True
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    name: '<string>',
    target: {type: 'agent', agent_id: '<string>'},
    cron: '<string>',
    timezone: 'UTC',
    message_template: '<string>',
    enabled: true
  })
};

fetch('https://api.omnara.com/v1/orgs/{orgID}/projects/{projectID}/cron-triggers', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.omnara.com/v1/orgs/{orgID}/projects/{projectID}/cron-triggers",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'name' => '<string>',
    'target' => [
        'type' => 'agent',
        'agent_id' => '<string>'
    ],
    'cron' => '<string>',
    'timezone' => 'UTC',
    'message_template' => '<string>',
    'enabled' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.omnara.com/v1/orgs/{orgID}/projects/{projectID}/cron-triggers"

	payload := strings.NewReader("{\n  \"name\": \"<string>\",\n  \"target\": {\n    \"type\": \"agent\",\n    \"agent_id\": \"<string>\"\n  },\n  \"cron\": \"<string>\",\n  \"timezone\": \"UTC\",\n  \"message_template\": \"<string>\",\n  \"enabled\": true\n}")

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

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.omnara.com/v1/orgs/{orgID}/projects/{projectID}/cron-triggers")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"<string>\",\n  \"target\": {\n    \"type\": \"agent\",\n    \"agent_id\": \"<string>\"\n  },\n  \"cron\": \"<string>\",\n  \"timezone\": \"UTC\",\n  \"message_template\": \"<string>\",\n  \"enabled\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.omnara.com/v1/orgs/{orgID}/projects/{projectID}/cron-triggers")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"name\": \"<string>\",\n  \"target\": {\n    \"type\": \"agent\",\n    \"agent_id\": \"<string>\"\n  },\n  \"cron\": \"<string>\",\n  \"timezone\": \"UTC\",\n  \"message_template\": \"<string>\",\n  \"enabled\": true\n}"

response = http.request(request)
puts response.read_body

{
  "id": "<string>",
  "org_id": "<string>",
  "project_id": "<string>",
  "name": "<string>",
  "target": {
    "type": "agent",
    "agent_id": "<string>",
    "delivery_mode": "queued"
  },
  "cron": "<string>",
  "timezone": "UTC",
  "enabled": true,
  "last_fired_at": "2023-11-07T05:31:56Z",
  "next_fire_at": "2023-11-07T05:31:56Z",
  "failure_report": {
    "message": "<string>",
    "will_retry": true,
    "failed_at": "2023-11-07T05:31:56Z"
  },
  "last_run": {
    "state": "queued",
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z",
    "failure_message": "<string>"
  },
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "message_template": "<string>"
}

{
  "id": "<string>",
  "org_id": "<string>",
  "project_id": "<string>",
  "name": "<string>",
  "target": {
    "type": "agent",
    "agent_id": "<string>",
    "delivery_mode": "queued"
  },
  "cron": "<string>",
  "timezone": "UTC",
  "enabled": true,
  "last_fired_at": "2023-11-07T05:31:56Z",
  "next_fire_at": "2023-11-07T05:31:56Z",
  "failure_report": {
    "message": "<string>",
    "will_retry": true,
    "failed_at": "2023-11-07T05:31:56Z"
  },
  "last_run": {
    "state": "queued",
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z",
    "failure_message": "<string>"
  },
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "message_template": "<string>"
}

{
  "error": "<string>",
  "code": "<string>",
  "current_digest": "<string>",
  "issues": [
    {
      "path": "<string>",
      "message": "<string>",
      "line": 2,
      "column": 2
    }
  ]
}

{
  "error": "<string>",
  "code": "<string>",
  "current_digest": "<string>",
  "issues": [
    {
      "path": "<string>",
      "message": "<string>",
      "line": 2,
      "column": 2
    }
  ]
}

{
  "error": "<string>",
  "code": "<string>",
  "current_digest": "<string>",
  "issues": [
    {
      "path": "<string>",
      "message": "<string>",
      "line": 2,
      "column": 2
    }
  ]
}

{
  "error": "<string>",
  "code": "<string>",
  "current_digest": "<string>",
  "issues": [
    {
      "path": "<string>",
      "message": "<string>",
      "line": 2,
      "column": 2
    }
  ]
}

{
  "error": "<string>",
  "code": "<string>",
  "current_digest": "<string>",
  "issues": [
    {
      "path": "<string>",
      "message": "<string>",
      "line": 2,
      "column": 2
    }
  ]
}

{
  "error": "<string>",
  "code": "<string>",
  "current_digest": "<string>",
  "issues": [
    {
      "path": "<string>",
      "message": "<string>",
      "line": 2,
      "column": 2
    }
  ]
}

{
  "error": "<string>",
  "code": "<string>"
}

{
  "error": "<string>",
  "code": "<string>"
}

Configs and Profiles

Create cron trigger

Creates a cron trigger that fires on a schedule. A trigger targeting an agent profile launches a new agent from the profile’s current config on each firing; a trigger targeting an agent sends an input to that agent. Missed firings are coalesced, matching standard cron behavior: if one or more scheduled times pass while firing is delayed, the trigger fires once for the oldest missed time and then resumes its schedule from the current time, without retroactively firing for the other missed times.

POST

orgs

{orgID}

projects

{projectID}

cron-triggers

Create cron trigger

curl --request POST \
  --url https://api.omnara.com/v1/orgs/{orgID}/projects/{projectID}/cron-triggers \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "target": {
    "type": "agent",
    "agent_id": "<string>"
  },
  "cron": "<string>",
  "timezone": "UTC",
  "message_template": "<string>",
  "enabled": true
}
'

import requests

url = "https://api.omnara.com/v1/orgs/{orgID}/projects/{projectID}/cron-triggers"

payload = {
    "name": "<string>",
    "target": {
        "type": "agent",
        "agent_id": "<string>"
    },
    "cron": "<string>",
    "timezone": "UTC",
    "message_template": "<string>",
    "enabled": True
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    name: '<string>',
    target: {type: 'agent', agent_id: '<string>'},
    cron: '<string>',
    timezone: 'UTC',
    message_template: '<string>',
    enabled: true
  })
};

fetch('https://api.omnara.com/v1/orgs/{orgID}/projects/{projectID}/cron-triggers', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.omnara.com/v1/orgs/{orgID}/projects/{projectID}/cron-triggers",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'name' => '<string>',
    'target' => [
        'type' => 'agent',
        'agent_id' => '<string>'
    ],
    'cron' => '<string>',
    'timezone' => 'UTC',
    'message_template' => '<string>',
    'enabled' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.omnara.com/v1/orgs/{orgID}/projects/{projectID}/cron-triggers"

	payload := strings.NewReader("{\n  \"name\": \"<string>\",\n  \"target\": {\n    \"type\": \"agent\",\n    \"agent_id\": \"<string>\"\n  },\n  \"cron\": \"<string>\",\n  \"timezone\": \"UTC\",\n  \"message_template\": \"<string>\",\n  \"enabled\": true\n}")

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

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.omnara.com/v1/orgs/{orgID}/projects/{projectID}/cron-triggers")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"<string>\",\n  \"target\": {\n    \"type\": \"agent\",\n    \"agent_id\": \"<string>\"\n  },\n  \"cron\": \"<string>\",\n  \"timezone\": \"UTC\",\n  \"message_template\": \"<string>\",\n  \"enabled\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.omnara.com/v1/orgs/{orgID}/projects/{projectID}/cron-triggers")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"name\": \"<string>\",\n  \"target\": {\n    \"type\": \"agent\",\n    \"agent_id\": \"<string>\"\n  },\n  \"cron\": \"<string>\",\n  \"timezone\": \"UTC\",\n  \"message_template\": \"<string>\",\n  \"enabled\": true\n}"

response = http.request(request)
puts response.read_body

{
  "id": "<string>",
  "org_id": "<string>",
  "project_id": "<string>",
  "name": "<string>",
  "target": {
    "type": "agent",
    "agent_id": "<string>",
    "delivery_mode": "queued"
  },
  "cron": "<string>",
  "timezone": "UTC",
  "enabled": true,
  "last_fired_at": "2023-11-07T05:31:56Z",
  "next_fire_at": "2023-11-07T05:31:56Z",
  "failure_report": {
    "message": "<string>",
    "will_retry": true,
    "failed_at": "2023-11-07T05:31:56Z"
  },
  "last_run": {
    "state": "queued",
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z",
    "failure_message": "<string>"
  },
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "message_template": "<string>"
}

{
  "id": "<string>",
  "org_id": "<string>",
  "project_id": "<string>",
  "name": "<string>",
  "target": {
    "type": "agent",
    "agent_id": "<string>",
    "delivery_mode": "queued"
  },
  "cron": "<string>",
  "timezone": "UTC",
  "enabled": true,
  "last_fired_at": "2023-11-07T05:31:56Z",
  "next_fire_at": "2023-11-07T05:31:56Z",
  "failure_report": {
    "message": "<string>",
    "will_retry": true,
    "failed_at": "2023-11-07T05:31:56Z"
  },
  "last_run": {
    "state": "queued",
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z",
    "failure_message": "<string>"
  },
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "message_template": "<string>"
}

{
  "error": "<string>",
  "code": "<string>",
  "current_digest": "<string>",
  "issues": [
    {
      "path": "<string>",
      "message": "<string>",
      "line": 2,
      "column": 2
    }
  ]
}

{
  "error": "<string>",
  "code": "<string>",
  "current_digest": "<string>",
  "issues": [
    {
      "path": "<string>",
      "message": "<string>",
      "line": 2,
      "column": 2
    }
  ]
}

{
  "error": "<string>",
  "code": "<string>",
  "current_digest": "<string>",
  "issues": [
    {
      "path": "<string>",
      "message": "<string>",
      "line": 2,
      "column": 2
    }
  ]
}

{
  "error": "<string>",
  "code": "<string>",
  "current_digest": "<string>",
  "issues": [
    {
      "path": "<string>",
      "message": "<string>",
      "line": 2,
      "column": 2
    }
  ]
}

{
  "error": "<string>",
  "code": "<string>",
  "current_digest": "<string>",
  "issues": [
    {
      "path": "<string>",
      "message": "<string>",
      "line": 2,
      "column": 2
    }
  ]
}

{
  "error": "<string>",
  "code": "<string>",
  "current_digest": "<string>",
  "issues": [
    {
      "path": "<string>",
      "message": "<string>",
      "line": 2,
      "column": 2
    }
  ]
}

{
  "error": "<string>",
  "code": "<string>"
}

{
  "error": "<string>",
  "code": "<string>"
}

Authorizations

Authorization

string

header

required

An opaque Omnara personal or organization bearer token.

Headers

Idempotency-Key

string

Idempotency key for replay-safe mutating requests.

Required string length: 1 - 255

Path Parameters

orgID

string

required

Pattern: ^org_[a-z2-7]{26}$

projectID

string

required

Pattern: ^proj_[a-z2-7]{26}$

Body

application/json

name

string

required

Human-readable name. Spaces and punctuation are allowed; leading or trailing whitespace and invisible or control characters are not.

Required string length: 1 - 64

target

object

required

Option 1
Option 2
Option 3

Show child attributes

cron

string

required

Standard five-field cron expression (minute, hour, day of month, month, day of week). TZ=/CRON_TZ= prefixes are rejected; set the timezone field instead.

Required string length: 9 - 256

timezone

string

default:UTC

IANA time zone the schedule is evaluated in.

Maximum string length: 64

message_template

string

Go text/template rendered on each firing to produce the message sent to the target. The template receives a trigger value with name, fired_at, last_fired_at, and local_date fields. Timestamps remain UTC; local_date is the scheduled occurrence's ISO date in the schedule timezone. Required for agent and profile targets; omitted for integration targets, which use their own settings. Rendering is capped at 64 KiB of output and one second of wall-clock time, and printf width and precision specifiers are capped at 1024; a firing whose template fails to render is recorded in failure_report without sending a message.

Maximum string length: 65536

enabled

boolean

default:true

Response

Existing cron trigger returned.

string

required

Pattern: ^cron_[a-z2-7]{26}$

org_id

string

required

Pattern: ^org_[a-z2-7]{26}$

project_id

string

required

Pattern: ^proj_[a-z2-7]{26}$

name

string

required

Human-readable name. Spaces and punctuation are allowed; leading or trailing whitespace and invisible or control characters are not.

Required string length: 1 - 64

target

object

required

Option 1
Option 2
Option 3

Show child attributes

cron

string

required

Standard five-field cron expression (minute, hour, day of month, month, day of week). TZ=/CRON_TZ= prefixes are rejected; set the timezone field instead.

Required string length: 9 - 256

timezone

string

default:UTC

required

IANA time zone the schedule is evaluated in.

Maximum string length: 64

enabled

boolean

required

last_fired_at

string<date-time> | null

required

When the trigger last fired, or null if it has never fired. For integration targets this means durable inbox handoff.

next_fire_at

string<date-time> | null

required

Next scheduled firing, or null while the trigger is disabled.

failure_report

object | null

required

Most recent failed firing, or null if no firing has failed since the last successful firing.

Show child attributes

last_run

object | null

required

Status of the latest accepted scheduled integration launch, scoped to this project and integration. Null for ordinary cron, before any launch is accepted, or when retained details have expired. Never falls back to an older launch. Schedule firing failures remain separate in failure_report. Deleting or disabling a schedule does not cancel launch work already accepted by the integration.

Show child attributes

created_at

string<date-time>

required

updated_at

string<date-time>

required

message_template

string

Maximum string length: 65536

API reference

Endpoints

Create cron trigger

Authorizations

Headers

Path Parameters

Body

Response