Triggers

List triggers

get

Authorizations

BearerAuth

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

is_activeany ofOptional

booleanOptional

or

nullOptional

limitinteger · max: 20OptionalDefault: 10

continuation_tokenintegerOptionalDefault: 0

Responses

200

Successful Response

application/json

has_morebooleanRequired

continuation_tokenany ofOptional

integerOptional

or

nullOptional

totalany ofOptional

integerOptional

or

nullOptional

422

Validation Error

application/json

429

Rate limited

get

/v1/{workspace_id}/triggers

HTTPcURLJavaScriptPython

GET /v1/{workspace_id}/triggers HTTP/1.1
Host: api.platform.amigo.ai
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-05-12T12:36:29.252Z",
      "is_active": true,
      "created_by": "text",
      "created_at": "2026-05-12T12:36:29.252Z",
      "updated_at": "2026-05-12T12:36:29.252Z"
    }
  ],
  "has_more": true,
  "continuation_token": 1,
  "total": 1
}

Create a trigger

post

Authorizations

BearerAuth

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

application/json

namestring · min: 1 · max: 256Required

descriptionany ofOptional

string · max: 2000Optional

or

nullOptional

event_typestring · min: 1 · max: 128RequiredPattern: ^[a-zA-Z0-9._\-:*]+$

event_filterany ofOptional

or

nullOptional

action_idstring · uuidRequired

scheduleany ofOptional

string · min: 1 · max: 128Optional

or

nullOptional

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

Responses

201

Successful Response

application/json

422

Validation error

429

Rate limited

post

/v1/{workspace_id}/triggers

HTTPcURLJavaScriptPython

POST /v1/{workspace_id}/triggers HTTP/1.1
Host: api.platform.amigo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 252

{
  "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": "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-05-12T12:36:29.252Z",
  "is_active": true,
  "created_by": "text",
  "created_at": "2026-05-12T12:36:29.252Z",
  "updated_at": "2026-05-12T12:36:29.252Z"
}

Get a trigger

get

Authorizations

BearerAuth

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

descriptionany ofOptional

Human-readable description

stringOptional

or

nullOptional

event_typestringRequired

Event type pattern to match

event_filterany ofOptional

JSONPath filter on event data

or

nullOptional

action_idstring · uuidRequired

Action (skill) to invoke when fired

scheduleany ofOptional

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

stringOptional

or

nullOptional

timezonestringRequired

IANA timezone for schedule evaluation

next_fire_atany ofOptional

Next scheduled fire time

string · date-timeOptional

or

nullOptional

is_activebooleanRequired

Whether the trigger is active

created_byany ofOptional

Entity ID of the creator

stringOptional

or

nullOptional

created_atany ofOptional

When the trigger was created

string · date-timeOptional

or

nullOptional

updated_atany ofOptional

When the trigger was last updated

string · date-timeOptional

or

nullOptional

404

Trigger not found

422

Validation Error

application/json

429

Rate limited

get

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

HTTPcURLJavaScriptPython

GET /v1/{workspace_id}/triggers/{trigger_id} HTTP/1.1
Host: api.platform.amigo.ai
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-05-12T12:36:29.252Z",
  "is_active": true,
  "created_by": "text",
  "created_at": "2026-05-12T12:36:29.252Z",
  "updated_at": "2026-05-12T12:36:29.252Z"
}

Update a trigger

put

Authorizations

BearerAuth

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

application/json

nameany ofOptional

string · min: 1 · max: 256Optional

or

nullOptional

descriptionany ofOptional

string · max: 2000Optional

or

nullOptional

event_typeany ofOptional

string · min: 1 · max: 128OptionalPattern: ^[a-zA-Z0-9._\-:*]+$

or

nullOptional

event_filterany ofOptional

or

nullOptional

action_idany ofOptional

string · uuidOptional

or

nullOptional

input_templateany ofOptional

or

nullOptional

scheduleany ofOptional

string · min: 1 · max: 128Optional

or

nullOptional

timezoneany ofOptional

string · min: 1 · max: 64Optional

or

nullOptional

Responses

200

Successful Response

application/json

idstring · uuidRequired

workspace_idstring · uuidRequired

namestringRequired

Trigger display name

descriptionany ofOptional

Human-readable description

stringOptional

or

nullOptional

event_typestringRequired

Event type pattern to match

event_filterany ofOptional

JSONPath filter on event data

or

nullOptional

action_idstring · uuidRequired

Action (skill) to invoke when fired

scheduleany ofOptional

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

stringOptional

or

nullOptional

timezonestringRequired

IANA timezone for schedule evaluation

next_fire_atany ofOptional

Next scheduled fire time

string · date-timeOptional

or

nullOptional

is_activebooleanRequired

Whether the trigger is active

created_byany ofOptional

Entity ID of the creator

stringOptional

or

nullOptional

created_atany ofOptional

When the trigger was created

string · date-timeOptional

or

nullOptional

updated_atany ofOptional

When the trigger was last updated

string · date-timeOptional

or

nullOptional

404

Trigger not found

422

Validation error

429

Rate limited

put

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

HTTPcURLJavaScriptPython

PUT /v1/{workspace_id}/triggers/{trigger_id} HTTP/1.1
Host: api.platform.amigo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 253

{
  "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"
}

{
  "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-05-12T12:36:29.252Z",
  "is_active": true,
  "created_by": "text",
  "created_at": "2026-05-12T12:36:29.252Z",
  "updated_at": "2026-05-12T12:36:29.252Z"
}

Delete a trigger

delete

Authorizations

BearerAuth

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

422

Validation Error

application/json

429

Rate limited

delete

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

HTTPcURLJavaScriptPython

DELETE /v1/{workspace_id}/triggers/{trigger_id} HTTP/1.1
Host: api.platform.amigo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

Pause a trigger

post

Authorizations

BearerAuth

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

descriptionany ofOptional

Human-readable description

stringOptional

or

nullOptional

event_typestringRequired

Event type pattern to match

event_filterany ofOptional

JSONPath filter on event data

or

nullOptional

action_idstring · uuidRequired

Action (skill) to invoke when fired

scheduleany ofOptional

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

stringOptional

or

nullOptional

timezonestringRequired

IANA timezone for schedule evaluation

next_fire_atany ofOptional

Next scheduled fire time

string · date-timeOptional

or

nullOptional

is_activebooleanRequired

Whether the trigger is active

created_byany ofOptional

Entity ID of the creator

stringOptional

or

nullOptional

created_atany ofOptional

When the trigger was created

string · date-timeOptional

or

nullOptional

updated_atany ofOptional

When the trigger was last updated

string · date-timeOptional

or

nullOptional

404

Trigger not found

422

Validation error

429

Rate limited

post

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

HTTPcURLJavaScriptPython

POST /v1/{workspace_id}/triggers/{trigger_id}/pause HTTP/1.1
Host: api.platform.amigo.ai
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-05-12T12:36:29.252Z",
  "is_active": true,
  "created_by": "text",
  "created_at": "2026-05-12T12:36:29.252Z",
  "updated_at": "2026-05-12T12:36:29.252Z"
}

Resume a trigger

post

Authorizations

BearerAuth

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

descriptionany ofOptional

Human-readable description

stringOptional

or

nullOptional

event_typestringRequired

Event type pattern to match

event_filterany ofOptional

JSONPath filter on event data

or

nullOptional

action_idstring · uuidRequired

Action (skill) to invoke when fired

scheduleany ofOptional

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

stringOptional

or

nullOptional

timezonestringRequired

IANA timezone for schedule evaluation

next_fire_atany ofOptional

Next scheduled fire time

string · date-timeOptional

or

nullOptional

is_activebooleanRequired

Whether the trigger is active

created_byany ofOptional

Entity ID of the creator

stringOptional

or

nullOptional

created_atany ofOptional

When the trigger was created

string · date-timeOptional

or

nullOptional

updated_atany ofOptional

When the trigger was last updated

string · date-timeOptional

or

nullOptional

404

Trigger not found

422

Validation error

429

Rate limited

post

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

HTTPcURLJavaScriptPython

POST /v1/{workspace_id}/triggers/{trigger_id}/resume HTTP/1.1
Host: api.platform.amigo.ai
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-05-12T12:36:29.252Z",
  "is_active": true,
  "created_by": "text",
  "created_at": "2026-05-12T12:36:29.252Z",
  "updated_at": "2026-05-12T12:36:29.252Z"
}

Manually fire a trigger now

post

Authorizations

BearerAuth

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

application/json

or

nullOptional

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

HTTPcURLJavaScriptPython

POST /v1/{workspace_id}/triggers/{trigger_id}/fire HTTP/1.1
Host: api.platform.amigo.ai
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 Lakebase entity-event timeline read model.

Authorizations

BearerAuth

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: 20OptionalDefault: 10

continuation_tokenintegerOptionalDefault: 0

Responses

200

Successful Response

application/json

has_morebooleanRequired

continuation_tokenany ofOptional

integerOptional

or

nullOptional

totalany ofOptional

integerOptional

or

nullOptional

422

Validation Error

application/json

429

Rate limited

get

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

HTTPcURLJavaScriptPython

GET /v1/{workspace_id}/triggers/{trigger_id}/runs HTTP/1.1
Host: api.platform.amigo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "items": [
    {
      "event_id": "123e4567-e89b-12d3-a456-426614174000",
      "event_type": "text",
      "data": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "effective_at": "2026-05-12T12:36:29.252Z",
      "created_at": "2026-05-12T12:36:29.252Z"
    }
  ],
  "has_more": true,
  "continuation_token": 1,
  "total": 1
}