SnozeDevelopers
API referenceConnectors

List connectors and their actions

Returns every app Snoze can act in (Gmail, Slack, Linear, Stripe, ...) with its actions, each action's input JSON Schema and access level (read, write or destructive), the table columns of actions that read as a table, and the accounts the caller may run each app on in this workspace: the workspace's connections and, for personal apps like email, the caller's own accounts.

GET
/v1/workspaces/{workspaceId}/connectors

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

Response Body

Success

application/json
  1. response
data*array<>
Example Request
curl -X GET 'https://api.snoze.dev/v1/workspaces/string/connectors'
Example Response
{  "data": [    {      "id": "string",      "label": "string",      "description": "string",      "provider": "string",      "personal": true,      "icon": "string",      "actions": [        {          "id": "string",          "key": "string",          "label": "string",          "description": "string",          "access": "read",          "idempotent": true,          "private": true,          "inputSchema": {},          "dataset": {            "fields": [              {                "key": "string",                "label": "string",                "kind": "text",                "options": [                  "string"                ]              }            ],            "title": "string",            "url": "string",            "time": "string"          }        }      ],      "accounts": [        {          "id": "string",          "kind": "workspace",          "label": "string",          "available": true,          "reason": "string"        }      ]    }  ]}

List recent API request log entries

Returns recent API requests recorded for the workspace — method, path, status, principal, idempotency key, duration, and error label — so key usage can be audited. Requires the `api_keys:read` permission. Pass `limit` to cap how many entries come back; a non-integer `limit` is a validation error.

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.