List recent provider operation runs
Returns the workspace's most recent provider operation runs with their status and results. Requires the `integrations:read` workspace permission. Pass `limit` to cap how many runs come back.
Authorization
apiKey Workspace API key created in Workspace settings → API keys. Scopes on the key bound what it can read and write.
In: header
Path Parameters
Query Parameters
Response Body
application/json
application/json
application/json
curl -X GET "https://example.com/v1/workspaces/string/integrations/operation-runs"{ "data": [ { "id": "string", "workspaceId": "string", "connectionId": "string", "provider": "string", "operation": "string", "resourceId": "string", "status": "running", "input": {}, "output": {}, "error": "string", "actorUserId": "string", "startedAt": "string", "completedAt": "string" } ]}{ "_tag": "ApiNotFound", "error": "not_found", "message": "That item does not exist, or this key cannot see it.", "status": 404}{ "_tag": "ApiNotFound", "error": "not_found", "message": "That item does not exist, or this key cannot see it.", "status": 404}Run a provider operation through a connection
Executes one registered provider operation against a connection, targeting either a linked resource or an external reference, and returns the run with its status and output. Requires the `integrations:read` workspace permission, and additionally `integrations:write` when the operation mutates the provider; operations marked as requiring confirmation are refused unless the body sets `confirmed`. An unregistered operation is rejected with the provider's registered operation ids named. After a successful run the workspace's cached provider content is dropped and a connector refresh is attempted so native mirrors catch up. Send an `Idempotency-Key` header to make retries safe; a replay within the window returns the original response.
Read the authenticated actor for the current session
Returns the resolved actor for the current request, including the identity the rest of the API authorizes against. Requires a Clerk session with a synced Snoze profile; API keys are rejected.