Triggers

List triggers

get

Authorizations

AuthorizationstringRequired

API key issued via POST /v1/{workspace_id}/api-keys. Pass the returned api_key value as a Bearer token.

Path parameters

workspace_idstring · uuidRequired

Query parameters

limitinteger · max: 200OptionalDefault: 50

continuation_tokenanyOptional

is_activeboolean · nullableOptional

Responses

200

Successful Response

application/json

has_morebooleanRequired

continuation_tokenanyOptional

422

Validation Error

application/json

429

Rate limited

get/v1/{workspace_id}/triggers

GET /v1/{workspace_id}/triggers HTTP/1.1
Host: platform.api-us.concurrence.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "items": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "workspace_id": "123e4567-e89b-12d3-a456-426614174000",
      "name": "text",
      "description": "text",
      "event_type": "text",
      "event_filter": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "action_id": "123e4567-e89b-12d3-a456-426614174000",
      "input_template": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "schedule": "text",
      "timezone": "text",
      "next_fire_at": "2026-01-01T00:00:00.000Z",
      "is_active": true,
      "created_by": "text",
      "created_at": "2026-01-01T00:00:00.000Z",
      "updated_at": "2026-01-01T00:00:00.000Z"
    }
  ],
  "has_more": true,
  "continuation_token": null
}

Create a trigger

post

Authorizations

AuthorizationstringRequired

API key issued via POST /v1/{workspace_id}/api-keys. Pass the returned api_key value as a Bearer token.

Path parameters

workspace_idstring · uuidRequired

Body

namestring · min: 1 · max: 256Required

descriptionstring · max: 2000 · nullableOptional

event_typestring · enumRequired

Closed set of world events that trigger definitions may subscribe to.

The database column intentionally remains text for compatibility with old rows, but API writes must choose from this list so typoed event names do not silently create never-matching triggers.

Possible values:

action_idstring · uuidRequired

schedulestring · min: 1 · max: 128 · nullableOptional

timezonestring · min: 1 · max: 64OptionalDefault: UTC

Responses

201

Successful Response

application/json

idstring · uuidRequired

workspace_idstring · uuidRequired

namestringRequired

Trigger display name

descriptionstring · nullableOptional

Human-readable description

event_typestringRequired

Event type pattern to match

action_idstring · uuidRequired

Action (skill) to invoke when fired

schedulestring · nullableOptional

Cron schedule expression (e.g. '0 9 * * 1-5')

timezonestringRequired

IANA timezone for schedule evaluation

next_fire_atstring · date-time · nullableOptional

Next scheduled fire time

is_activebooleanRequired

Whether the trigger is active

created_bystring · nullableOptional

Entity ID of the creator

created_atstring · date-time · nullableOptional

When the trigger was created

updated_atstring · date-time · nullableOptional

When the trigger was last updated

422

Validation error

429

Rate limited

post/v1/{workspace_id}/triggers

POST /v1/{workspace_id}/triggers HTTP/1.1
Host: platform.api-us.concurrence.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 266

{
  "name": "text",
  "description": "text",
  "event_type": "amigo.trigger.cron",
  "event_filter": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "action_id": "123e4567-e89b-12d3-a456-426614174000",
  "input_template": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "schedule": "text",
  "timezone": "UTC"
}

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "workspace_id": "123e4567-e89b-12d3-a456-426614174000",
  "name": "text",
  "description": "text",
  "event_type": "text",
  "event_filter": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "action_id": "123e4567-e89b-12d3-a456-426614174000",
  "input_template": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "schedule": "text",
  "timezone": "text",
  "next_fire_at": "2026-01-01T00:00:00.000Z",
  "is_active": true,
  "created_by": "text",
  "created_at": "2026-01-01T00:00:00.000Z",
  "updated_at": "2026-01-01T00:00:00.000Z"
}

Get a trigger

get

Authorizations

AuthorizationstringRequired

API key issued via POST /v1/{workspace_id}/api-keys. Pass the returned api_key value as a Bearer token.

Path parameters

workspace_idstring · uuidRequired

trigger_idstring · uuidRequired

Responses

200

Successful Response

application/json

idstring · uuidRequired

workspace_idstring · uuidRequired

namestringRequired

Trigger display name

descriptionstring · nullableOptional

Human-readable description

event_typestringRequired

Event type pattern to match

action_idstring · uuidRequired

Action (skill) to invoke when fired

schedulestring · nullableOptional

Cron schedule expression (e.g. '0 9 * * 1-5')

timezonestringRequired

IANA timezone for schedule evaluation

next_fire_atstring · date-time · nullableOptional

Next scheduled fire time

is_activebooleanRequired

Whether the trigger is active

created_bystring · nullableOptional

Entity ID of the creator

created_atstring · date-time · nullableOptional

When the trigger was created

updated_atstring · date-time · nullableOptional

When the trigger was last updated

404

Trigger not found

422

Validation Error

application/json

429

Rate limited

get/v1/{workspace_id}/triggers/{trigger_id}

GET /v1/{workspace_id}/triggers/{trigger_id} HTTP/1.1
Host: platform.api-us.concurrence.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "workspace_id": "123e4567-e89b-12d3-a456-426614174000",
  "name": "text",
  "description": "text",
  "event_type": "text",
  "event_filter": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "action_id": "123e4567-e89b-12d3-a456-426614174000",
  "input_template": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "schedule": "text",
  "timezone": "text",
  "next_fire_at": "2026-01-01T00:00:00.000Z",
  "is_active": true,
  "created_by": "text",
  "created_at": "2026-01-01T00:00:00.000Z",
  "updated_at": "2026-01-01T00:00:00.000Z"
}

Update a trigger

put

Authorizations

AuthorizationstringRequired

API key issued via POST /v1/{workspace_id}/api-keys. Pass the returned api_key value as a Bearer token.

Path parameters

workspace_idstring · uuidRequired

trigger_idstring · uuidRequired

Body

namestring · min: 1 · max: 256 · nullableOptional

descriptionstring · max: 2000 · nullableOptional

event_typestring · enum · nullableOptional

Closed set of world events that trigger definitions may subscribe to.

The database column intentionally remains text for compatibility with old rows, but API writes must choose from this list so typoed event names do not silently create never-matching triggers.

Possible values:

action_idstring · uuid · nullableOptional

schedulestring · min: 1 · max: 128 · nullableOptional

timezonestring · min: 1 · max: 64 · nullableOptional

Responses

200

Successful Response

application/json

idstring · uuidRequired

workspace_idstring · uuidRequired

namestringRequired

Trigger display name

descriptionstring · nullableOptional

Human-readable description

event_typestringRequired

Event type pattern to match

action_idstring · uuidRequired

Action (skill) to invoke when fired

schedulestring · nullableOptional

Cron schedule expression (e.g. '0 9 * * 1-5')

timezonestringRequired

IANA timezone for schedule evaluation

next_fire_atstring · date-time · nullableOptional

Next scheduled fire time

is_activebooleanRequired

Whether the trigger is active

created_bystring · nullableOptional

Entity ID of the creator

created_atstring · date-time · nullableOptional

When the trigger was created

updated_atstring · date-time · nullableOptional

When the trigger was last updated

404

Trigger not found

422

Validation error

429

Rate limited

put/v1/{workspace_id}/triggers/{trigger_id}

PUT /v1/{workspace_id}/triggers/{trigger_id} HTTP/1.1
Host: platform.api-us.concurrence.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 267

{
  "name": "text",
  "description": "text",
  "event_type": "amigo.trigger.cron",
  "event_filter": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "action_id": "123e4567-e89b-12d3-a456-426614174000",
  "input_template": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "schedule": "text",
  "timezone": "text"
}

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "workspace_id": "123e4567-e89b-12d3-a456-426614174000",
  "name": "text",
  "description": "text",
  "event_type": "text",
  "event_filter": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "action_id": "123e4567-e89b-12d3-a456-426614174000",
  "input_template": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "schedule": "text",
  "timezone": "text",
  "next_fire_at": "2026-01-01T00:00:00.000Z",
  "is_active": true,
  "created_by": "text",
  "created_at": "2026-01-01T00:00:00.000Z",
  "updated_at": "2026-01-01T00:00:00.000Z"
}

Delete a trigger

delete

Authorizations

AuthorizationstringRequired

API key issued via POST /v1/{workspace_id}/api-keys. Pass the returned api_key value as a Bearer token.

Path parameters

workspace_idstring · uuidRequired

trigger_idstring · uuidRequired

Responses

204

Successful Response

No content

422

Validation Error

application/json

429

Rate limited

delete/v1/{workspace_id}/triggers/{trigger_id}

DELETE /v1/{workspace_id}/triggers/{trigger_id} HTTP/1.1
Host: platform.api-us.concurrence.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

Pause a trigger

post

Authorizations

AuthorizationstringRequired

API key issued via POST /v1/{workspace_id}/api-keys. Pass the returned api_key value as a Bearer token.

Path parameters

workspace_idstring · uuidRequired

trigger_idstring · uuidRequired

Responses

200

Successful Response

application/json

idstring · uuidRequired

workspace_idstring · uuidRequired

namestringRequired

Trigger display name

descriptionstring · nullableOptional

Human-readable description

event_typestringRequired

Event type pattern to match

action_idstring · uuidRequired

Action (skill) to invoke when fired

schedulestring · nullableOptional

Cron schedule expression (e.g. '0 9 * * 1-5')

timezonestringRequired

IANA timezone for schedule evaluation

next_fire_atstring · date-time · nullableOptional

Next scheduled fire time

is_activebooleanRequired

Whether the trigger is active

created_bystring · nullableOptional

Entity ID of the creator

created_atstring · date-time · nullableOptional

When the trigger was created

updated_atstring · date-time · nullableOptional

When the trigger was last updated

404

Trigger not found

422

Validation error

429

Rate limited

post/v1/{workspace_id}/triggers/{trigger_id}/pause

POST /v1/{workspace_id}/triggers/{trigger_id}/pause HTTP/1.1
Host: platform.api-us.concurrence.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "workspace_id": "123e4567-e89b-12d3-a456-426614174000",
  "name": "text",
  "description": "text",
  "event_type": "text",
  "event_filter": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "action_id": "123e4567-e89b-12d3-a456-426614174000",
  "input_template": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "schedule": "text",
  "timezone": "text",
  "next_fire_at": "2026-01-01T00:00:00.000Z",
  "is_active": true,
  "created_by": "text",
  "created_at": "2026-01-01T00:00:00.000Z",
  "updated_at": "2026-01-01T00:00:00.000Z"
}

Resume a trigger

post

Authorizations

AuthorizationstringRequired

API key issued via POST /v1/{workspace_id}/api-keys. Pass the returned api_key value as a Bearer token.

Path parameters

workspace_idstring · uuidRequired

trigger_idstring · uuidRequired

Responses

200

Successful Response

application/json

idstring · uuidRequired

workspace_idstring · uuidRequired

namestringRequired

Trigger display name

descriptionstring · nullableOptional

Human-readable description

event_typestringRequired

Event type pattern to match

action_idstring · uuidRequired

Action (skill) to invoke when fired

schedulestring · nullableOptional

Cron schedule expression (e.g. '0 9 * * 1-5')

timezonestringRequired

IANA timezone for schedule evaluation

next_fire_atstring · date-time · nullableOptional

Next scheduled fire time

is_activebooleanRequired

Whether the trigger is active

created_bystring · nullableOptional

Entity ID of the creator

created_atstring · date-time · nullableOptional

When the trigger was created

updated_atstring · date-time · nullableOptional

When the trigger was last updated

404

Trigger not found

422

Validation error

429

Rate limited

post/v1/{workspace_id}/triggers/{trigger_id}/resume

POST /v1/{workspace_id}/triggers/{trigger_id}/resume HTTP/1.1
Host: platform.api-us.concurrence.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "workspace_id": "123e4567-e89b-12d3-a456-426614174000",
  "name": "text",
  "description": "text",
  "event_type": "text",
  "event_filter": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "action_id": "123e4567-e89b-12d3-a456-426614174000",
  "input_template": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "schedule": "text",
  "timezone": "text",
  "next_fire_at": "2026-01-01T00:00:00.000Z",
  "is_active": true,
  "created_by": "text",
  "created_at": "2026-01-01T00:00:00.000Z",
  "updated_at": "2026-01-01T00:00:00.000Z"
}

Manually fire a trigger now

post

Authorizations

AuthorizationstringRequired

API key issued via POST /v1/{workspace_id}/api-keys. Pass the returned api_key value as a Bearer token.

Path parameters

workspace_idstring · uuidRequired

trigger_idstring · uuidRequired

Body

Responses

200

Successful Response

application/json

fired_event_idstring · uuidRequired

trigger_idstring · uuidRequired

statusconst: firedOptionalDefault: fired

404

Trigger not found

422

Validation error

429

Rate limited

503

Trigger scheduler not initialized

post/v1/{workspace_id}/triggers/{trigger_id}/fire

POST /v1/{workspace_id}/triggers/{trigger_id}/fire HTTP/1.1
Host: platform.api-us.concurrence.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 48

{
  "input": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
}

{
  "fired_event_id": "123e4567-e89b-12d3-a456-426614174000",
  "trigger_id": "123e4567-e89b-12d3-a456-426614174000",
  "status": "fired"
}

List trigger execution history

get

Execution history from the durable trigger run table.

Authorizations

AuthorizationstringRequired

API key issued via POST /v1/{workspace_id}/api-keys. Pass the returned api_key value as a Bearer token.

Path parameters

workspace_idstring · uuidRequired

trigger_idstring · uuidRequired

Query parameters

limitinteger · max: 200OptionalDefault: 50

continuation_tokenanyOptional

Responses

200

Successful Response

application/json

has_morebooleanRequired

continuation_tokenanyOptional

422

Validation Error

application/json

429

Rate limited

get/v1/{workspace_id}/triggers/{trigger_id}/runs

GET /v1/{workspace_id}/triggers/{trigger_id}/runs HTTP/1.1
Host: platform.api-us.concurrence.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "items": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "workspace_id": "123e4567-e89b-12d3-a456-426614174000",
      "trigger_id": "123e4567-e89b-12d3-a456-426614174000",
      "fired_event_id": "123e4567-e89b-12d3-a456-426614174000",
      "source": "cron",
      "input_override": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "status": "queued",
      "attempt_count": 1,
      "max_attempts": 1,
      "next_attempt_at": "2026-01-01T00:00:00.000Z",
      "claimed_by": "text",
      "claimed_at": "2026-01-01T00:00:00.000Z",
      "lease_expires_at": "2026-01-01T00:00:00.000Z",
      "result_text": "text",
      "error": "text",
      "created_at": "2026-01-01T00:00:00.000Z",
      "updated_at": "2026-01-01T00:00:00.000Z"
    }
  ],
  "has_more": true,
  "continuation_token": null
}