SnozeDevelopers
API referenceConnectors

Run a connector action

Runs one action (`linear.create_issue`) live in the app, on `connectionId` or on the caller's only usable account for that app. Writes on a workspace connection need the `integrations:write` permission; a person's own account (email) is usable only by them and never by an API key. Send an `Idempotency-Key` header to make retries safe; it is also handed to the app where it supports one.

POST
/v1/workspaces/{workspaceId}/connectors/actions/run

Authorization

apiKey
headerAuthorizationBearer <snoze_sk_…>

Workspace API key created in Workspace settings → API keys. Scopes on the key bound what it can read and write.

Path Parameters

workspaceId*string

Request Body

application/json
  1. body
action*string
input*
connectionId?string|null

Response Body

Success

application/json
  1. response
data*
Example Request
curl -X POST 'https://api.snoze.dev/v1/workspaces/string/connectors/actions/run' \  -H 'Content-Type: application/json' \  -d '{  "action": "string",  "input": {}}'
Example Response
{  "data": {    "action": "string",    "connectionId": "string",    "output": null  }}