Subscription Actions

List all actions for a subscription

GET
/v1/companies/signals/subscriptions/{subscriptionId}/actions

Retrieve a paginated list of actions configured on a subscription.

Authorization

ApiKeyAuth
AuthorizationBearer <token>

API key authentication using Bearer token. Format: sk_live_ followed by a secure random string.

In: header

Path Parameters

subscriptionId*string

The subscription whose actions to list

Formatuuid

Query Parameters

limit?integer

Maximum number of actions to return

Range1 <= value <= 100
Default20
offset?integer

Number of actions to skip for pagination

Range0 <= value
Default0

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/v1/companies/signals/subscriptions/497f6eca-6276-4993-bfeb-53cbbbba6f08/actions"
{  "items": [    {      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "subscriptionId": "d079718b-ff63-45dd-947b-4950c023750f",      "type": "webhook",      "webhook": {        "destination": "http://example.com"      },      "enabled": true,      "createdAt": "2019-08-24T14:15:22Z",      "updatedAt": "2019-08-24T14:15:22Z"    }  ],  "total": 0,  "limit": 0,  "offset": 0,  "hasMore": true}

Create a subscription action

POST
/v1/companies/signals/subscriptions/{subscriptionId}/actions

Create an action on a subscription. Actions define what happens when the subscription triggers (e.g., deliver results via webhook). A maximum of 10 actions per subscription is allowed.

Authorization

ApiKeyAuth
AuthorizationBearer <token>

API key authentication using Bearer token. Format: sk_live_ followed by a secure random string.

In: header

Path Parameters

subscriptionId*string

The subscription to add the action to

Formatuuid

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Create a new action on a subscription. The type field determines which configuration object is required.

type*"webhook"

The action type discriminator

Value in

  • "webhook"
webhook?

Configuration for a webhook action.

Response Body

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/companies/signals/subscriptions/497f6eca-6276-4993-bfeb-53cbbbba6f08/actions" \  -H "Content-Type: application/json" \  -d '{    "type": "webhook"  }'
{  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "subscriptionId": "d079718b-ff63-45dd-947b-4950c023750f",  "type": "webhook",  "webhook": {    "destination": "http://example.com"  },  "enabled": true,  "createdAt": "2019-08-24T14:15:22Z",  "updatedAt": "2019-08-24T14:15:22Z"}

Get a subscription action by ID

GET
/v1/companies/signals/subscriptions/{subscriptionId}/actions/{actionId}

Retrieve a single action by its ID.

Authorization

ApiKeyAuth
AuthorizationBearer <token>

API key authentication using Bearer token. Format: sk_live_ followed by a secure random string.

In: header

Path Parameters

subscriptionId*string

The subscription that owns the action

Formatuuid
actionId*string

The action ID

Formatuuid

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/v1/companies/signals/subscriptions/497f6eca-6276-4993-bfeb-53cbbbba6f08/actions/497f6eca-6276-4993-bfeb-53cbbbba6f08"
{  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "subscriptionId": "d079718b-ff63-45dd-947b-4950c023750f",  "type": "webhook",  "webhook": {    "destination": "http://example.com"  },  "enabled": true,  "createdAt": "2019-08-24T14:15:22Z",  "updatedAt": "2019-08-24T14:15:22Z"}

Delete a subscription action

DELETE
/v1/companies/signals/subscriptions/{subscriptionId}/actions/{actionId}

Permanently delete an action from a subscription.

Authorization

ApiKeyAuth
AuthorizationBearer <token>

API key authentication using Bearer token. Format: sk_live_ followed by a secure random string.

In: header

Path Parameters

subscriptionId*string

The subscription that owns the action

Formatuuid
actionId*string

The action ID to delete

Formatuuid

Response Body

application/json

application/json

curl -X DELETE "https://example.com/v1/companies/signals/subscriptions/497f6eca-6276-4993-bfeb-53cbbbba6f08/actions/497f6eca-6276-4993-bfeb-53cbbbba6f08"
Empty

Update a subscription action

PUT
/v1/companies/signals/subscriptions/{subscriptionId}/actions/{actionId}

Replace the configuration of an existing action. The action type is immutable; only the type-specific configuration can be updated.

Authorization

ApiKeyAuth
AuthorizationBearer <token>

API key authentication using Bearer token. Format: sk_live_ followed by a secure random string.

In: header

Path Parameters

subscriptionId*string

The subscription that owns the action

Formatuuid
actionId*string

The action ID to update

Formatuuid

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Update the configuration of an existing action. The action type is immutable; only the type-specific configuration can be changed.

webhook?

Configuration for a webhook action.

Response Body

application/json

application/json

application/json

application/json

curl -X PUT "https://example.com/v1/companies/signals/subscriptions/497f6eca-6276-4993-bfeb-53cbbbba6f08/actions/497f6eca-6276-4993-bfeb-53cbbbba6f08" \  -H "Content-Type: application/json" \  -d '{}'
{  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "subscriptionId": "d079718b-ff63-45dd-947b-4950c023750f",  "type": "webhook",  "webhook": {    "destination": "http://example.com"  },  "enabled": true,  "createdAt": "2019-08-24T14:15:22Z",  "updatedAt": "2019-08-24T14:15:22Z"}

Pause a subscription action

POST
/v1/companies/signals/subscriptions/{subscriptionId}/actions/{actionId}/pause

Disable an action so it is skipped during dispatch. The action configuration is preserved and can be re-enabled with unpause.

Authorization

ApiKeyAuth
AuthorizationBearer <token>

API key authentication using Bearer token. Format: sk_live_ followed by a secure random string.

In: header

Path Parameters

subscriptionId*string

The subscription that owns the action

Formatuuid
actionId*string

The action ID to pause

Formatuuid

Response Body

application/json

application/json

application/json

curl -X POST "https://example.com/v1/companies/signals/subscriptions/497f6eca-6276-4993-bfeb-53cbbbba6f08/actions/497f6eca-6276-4993-bfeb-53cbbbba6f08/pause"
{  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "subscriptionId": "d079718b-ff63-45dd-947b-4950c023750f",  "type": "webhook",  "webhook": {    "destination": "http://example.com"  },  "enabled": true,  "createdAt": "2019-08-24T14:15:22Z",  "updatedAt": "2019-08-24T14:15:22Z"}

Unpause a subscription action

POST
/v1/companies/signals/subscriptions/{subscriptionId}/actions/{actionId}/unpause

Re-enable a paused action so it resumes being dispatched when the subscription triggers.

Authorization

ApiKeyAuth
AuthorizationBearer <token>

API key authentication using Bearer token. Format: sk_live_ followed by a secure random string.

In: header

Path Parameters

subscriptionId*string

The subscription that owns the action

Formatuuid
actionId*string

The action ID to unpause

Formatuuid

Response Body

application/json

application/json

application/json

curl -X POST "https://example.com/v1/companies/signals/subscriptions/497f6eca-6276-4993-bfeb-53cbbbba6f08/actions/497f6eca-6276-4993-bfeb-53cbbbba6f08/unpause"
{  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "subscriptionId": "d079718b-ff63-45dd-947b-4950c023750f",  "type": "webhook",  "webhook": {    "destination": "http://example.com"  },  "enabled": true,  "createdAt": "2019-08-24T14:15:22Z",  "updatedAt": "2019-08-24T14:15:22Z"}

On this page

List all actions for a subscriptionCreate a subscription actionGet a subscription action by IDDelete a subscription actionUpdate a subscription actionPause a subscription actionUnpause a subscription action