Connections

Execute a connection tool

Run a tool on any connection by its unified id, with the account's approval policy enforced. always_allow runs now (200); always_ask freezes a pending approval (202); off / not-callable refused. Social/ads connections are operated via their native /v1 endpoints (409).

post/connections/{id}/execute

Request

  • Base URL: https://api.crevio.co/v1
  • URL: https://api.crevio.co/v1/connections/{id}/execute
  • Auth: API key in header Authorization

Path parameters

idstring required

Unified public connection id, as returned by GET /connections/connected. Opaque — pass it back verbatim.

Headers

Idempotency-Keystring

Makes this write safe to retry: a repeat with the same key replays the first response instead of creating a second resource. Scoped to the account, remembered for 24 hours; reusing a key with a different payload is an error.

Request body

toolstring required

Tool name from GET /connections/{id}/tools

argumentsobject

Tool-specific arguments

Response

Tool executed

object'connection_execution' required
connectionstring required

The connection public id

toolstring nullable
status'executed' required

Changes

No recorded changes to this operation across all 2 revisions of this API.