Triggers

Get Triggers

get

Authorizations

OAuth2PasswordBearer

OAuth2passwordRequired

Token URL:

Path parameters

project_idstringRequired

Responses

200

Successful Response

application/json

422

Validation Error

application/json

get

/projects/{project_id}/triggers

HTTPcURLJavaScriptPython

GET /projects/{project_id}/triggers HTTP/1.1
Host: api.stack-ai.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

[
  {
    "project_trigger_id": "123e4567-e89b-12d3-a456-426614174000",
    "project_id": "text",
    "connection_id": "123e4567-e89b-12d3-a456-426614174000",
    "provider_id": "text",
    "trigger_id": "text",
    "webhook_data": {
      "ANY_ADDITIONAL_PROPERTY": "anything"
    },
    "cursor_data": {
      "ANY_ADDITIONAL_PROPERTY": "anything"
    },
    "trigger_config": {
      "ANY_ADDITIONAL_PROPERTY": "anything"
    },
    "status": "DISABLED",
    "created_at": "2026-01-29T16:00:17.005Z",
    "updated_at": "2026-01-29T16:00:17.005Z",
    "created_by": "123e4567-e89b-12d3-a456-426614174000",
    "updated_by": "123e4567-e89b-12d3-a456-426614174000"
  }
]

Create Trigger

post

Authorizations

OAuth2PasswordBearer

OAuth2passwordRequired

Token URL:

Path parameters

project_idstringRequired

Body

application/json

A domain model representing a request to create a new Trigger.

provider_idstringRequired

trigger_idstringRequired

connection_idany ofOptional

string · uuidOptional

or

nullOptional

Responses

201

Successful Response

application/json

422

Validation Error

application/json

post

/projects/{project_id}/triggers

HTTPcURLJavaScriptPython

POST /projects/{project_id}/triggers HTTP/1.1
Host: api.stack-ai.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 160

{
  "provider_id": "text",
  "trigger_id": "text",
  "trigger_config_params": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "connection_id": "123e4567-e89b-12d3-a456-426614174000"
}

{
  "project_trigger_id": "123e4567-e89b-12d3-a456-426614174000",
  "project_id": "text",
  "connection_id": "123e4567-e89b-12d3-a456-426614174000",
  "provider_id": "text",
  "trigger_id": "text",
  "webhook_data": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "cursor_data": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "trigger_config": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "status": "DISABLED",
  "created_at": "2026-01-29T16:00:17.005Z",
  "updated_at": "2026-01-29T16:00:17.005Z",
  "created_by": "123e4567-e89b-12d3-a456-426614174000",
  "updated_by": "123e4567-e89b-12d3-a456-426614174000"
}

Get Trigger

get

Authorizations

OAuth2PasswordBearer

OAuth2passwordRequired

Token URL:

Path parameters

project_trigger_idstring · uuidRequired

Responses

200

Successful Response

application/json

422

Validation Error

application/json

get

/triggers/{project_trigger_id}

HTTPcURLJavaScriptPython

GET /triggers/{project_trigger_id} HTTP/1.1
Host: api.stack-ai.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

{
  "project_trigger_id": "123e4567-e89b-12d3-a456-426614174000",
  "project_id": "text",
  "connection_id": "123e4567-e89b-12d3-a456-426614174000",
  "provider_id": "text",
  "trigger_id": "text",
  "webhook_data": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "cursor_data": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "trigger_config": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "status": "DISABLED",
  "created_at": "2026-01-29T16:00:17.005Z",
  "updated_at": "2026-01-29T16:00:17.005Z",
  "created_by": "123e4567-e89b-12d3-a456-426614174000",
  "updated_by": "123e4567-e89b-12d3-a456-426614174000"
}

Delete Trigger

delete

Authorizations

OAuth2PasswordBearer

OAuth2passwordRequired

Token URL:

Path parameters

project_trigger_idstring · uuidRequired

Responses

204

Successful Response

422

Validation Error

application/json

delete

/triggers/{project_trigger_id}

HTTPcURLJavaScriptPython

DELETE /triggers/{project_trigger_id} HTTP/1.1
Host: api.stack-ai.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

No content

Get Triggers By User Org

get

Authorizations

OAuth2PasswordBearer

OAuth2passwordRequired

Token URL:

Responses

200

Successful Response

application/json

get

/triggers

HTTPcURLJavaScriptPython

GET /triggers HTTP/1.1
Host: api.stack-ai.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

200

Successful Response

[
  {
    "project_trigger": {
      "project_trigger_id": "123e4567-e89b-12d3-a456-426614174000",
      "project_id": "text",
      "connection_id": "123e4567-e89b-12d3-a456-426614174000",
      "provider_id": "text",
      "trigger_id": "text",
      "webhook_data": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "cursor_data": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "trigger_config": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "status": "DISABLED",
      "created_at": "2026-01-29T16:00:17.005Z",
      "updated_at": "2026-01-29T16:00:17.005Z",
      "created_by": "123e4567-e89b-12d3-a456-426614174000",
      "updated_by": "123e4567-e89b-12d3-a456-426614174000"
    },
    "project_name": "text"
  }
]

Enable Trigger

post

Authorizations

OAuth2PasswordBearer

OAuth2passwordRequired

Token URL:

Path parameters

project_trigger_idstring · uuidRequired

Responses

200

Successful Response

application/json

Responseany

422

Validation Error

application/json

post

/triggers/{project_trigger_id}/enable

HTTPcURLJavaScriptPython

POST /triggers/{project_trigger_id}/enable HTTP/1.1
Host: api.stack-ai.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

No content

Disable Trigger

post

Authorizations

OAuth2PasswordBearer

OAuth2passwordRequired

Token URL:

Path parameters

project_trigger_idstring · uuidRequired

Responses

200

Successful Response

application/json

Responseany

422

Validation Error

application/json

post

/triggers/{project_trigger_id}/disable

HTTPcURLJavaScriptPython

POST /triggers/{project_trigger_id}/disable HTTP/1.1
Host: api.stack-ai.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

No content

Get Available Triggers By Provider

get

Get the list of native triggers available and implemented by Stack AI.

Path parameters

provider_idstringRequired

Responses

200

Successful Response

application/json

422

Validation Error

application/json

get

/providers/{provider_id}/triggers

HTTPcURLJavaScriptPython

GET /providers/{provider_id}/triggers HTTP/1.1
Host: api.stack-ai.com
Accept: */*

[
  {
    "trigger_type": "POLLING",
    "provider_id": "text",
    "trigger_id": "text",
    "trigger_name": "text",
    "description": "text",
    "instructions": "text",
    "icon": "text",
    "tags": [
      "text"
    ],
    "version": "1.0.0",
    "webhook_requires_verification": false,
    "can_get_test_samples": true
  }
]

Get Specific Trigger From Provider

get

Get the data for a specific native trigger available and implemented by Stack AI.

Path parameters

provider_idstringRequired

trigger_idstringRequired

Responses

200

Successful Response

application/json

422

Validation Error

application/json

get

/providers/{provider_id}/triggers/{trigger_id}

HTTPcURLJavaScriptPython

GET /providers/{provider_id}/triggers/{trigger_id} HTTP/1.1
Host: api.stack-ai.com
Accept: */*

{
  "trigger_type": "POLLING",
  "provider_id": "text",
  "trigger_id": "text",
  "trigger_name": "text",
  "description": "text",
  "instructions": "text",
  "icon": "text",
  "tags": [
    "text"
  ],
  "version": "1.0.0",
  "webhook_requires_verification": false,
  "can_get_test_samples": true
}

Deprecated

Webhook Trigger

post

Path parameters

project_trigger_idstring · uuidRequired

api_keystringRequired

org_idstringRequired

Query parameters

trigger_idany ofOptional

stringOptional

or

nullOptional

provider_idany ofOptional

stringOptional

or

nullOptional

Responses

202

Successful Response

application/json

422

Validation Error

application/json

post

/organizations/{org_id}/triggers/{project_trigger_id}/webhook/key/{api_key}

HTTPcURLJavaScriptPython

POST /organizations/{org_id}/triggers/{project_trigger_id}/webhook/key/{api_key} HTTP/1.1
Host: api.stack-ai.com
Accept: */*

No content

Deprecated

Polling Trigger

post

Path parameters

project_trigger_idstring · uuidRequired

api_keystringRequired

org_idstringRequired

Responses

202

Successful Response

application/json

422

Validation Error

application/json

post

/organizations/{org_id}/triggers/{project_trigger_id}/polling/key/{api_key}

HTTPcURLJavaScriptPython

POST /organizations/{org_id}/triggers/{project_trigger_id}/polling/key/{api_key} HTTP/1.1
Host: api.stack-ai.com
Accept: */*

No content

Deprecated

Scheduled Trigger

post

Path parameters

project_trigger_idstring · uuidRequired

api_keystringRequired

org_idstringRequired

Responses

202

Successful Response

application/json

422

Validation Error

application/json

post

/organizations/{org_id}/triggers/{project_trigger_id}/scheduled/key/{api_key}

HTTPcURLJavaScriptPython

POST /organizations/{org_id}/triggers/{project_trigger_id}/scheduled/key/{api_key} HTTP/1.1
Host: api.stack-ai.com
Accept: */*

No content

Webhook Handler

post

Handle webhook requests for all incoming webhook events.

Path parameters

webhook_idstringRequired

Webhook identifier - either an app webhook provider (e.g., 'slack', 'github') or a project trigger UUID

Example: slack

Responses

200

Successful Response

application/json

Responseany

422

Validation Error

application/json

post

/v1/webhooks/{webhook_id}

HTTPcURLJavaScriptPython

POST /v1/webhooks/{webhook_id} HTTP/1.1
Host: api.stack-ai.com
Accept: */*

No content

Get Trigger Test Samples

get

Get test samples for a trigger.

Authorizations

OAuth2PasswordBearer

OAuth2passwordRequired

Token URL:

Path parameters

project_trigger_idstring · uuidRequired

Responses

200

Successful Response

application/json

422

Validation Error

application/json

get

/api/v0/project-triggers/{project_trigger_id}/test-samples

HTTPcURLJavaScriptPython

GET /api/v0/project-triggers/{project_trigger_id}/test-samples HTTP/1.1
Host: api.stack-ai.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

{
  "ANY_ADDITIONAL_PROPERTY": "anything"
}