SnozeDevelopers
API referenceConnectors

Read a connector action as a table

Runs a read action that declares table columns (`stripe.list_invoices`, `linear.search_issues`) and returns its rows keyed by those columns, with when they were read. Nothing is stored: the rows come live from the app, briefly cached. Used by dashboard widgets, page embeds and saving rows to a database.

POST
/v1/workspaces/{workspaceId}/connectors/dataset

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/dataset' \  -H 'Content-Type: application/json' \  -d '{  "action": "string",  "input": {}}'
Example Response
{  "data": {    "action": "string",    "connectionId": "string",    "dataset": {      "fields": [        {          "key": "string",          "label": "string",          "kind": "text",          "options": [            "string"          ]        }      ],      "title": "string",      "url": "string",      "time": "string"    },    "rows": [      {}    ],    "fetchedAt": "string",    "more": true  }}