Error

A valid request URL is required to generate request examples

{
  "data": {
    "durationMs": 1840,
    "leaves": [
      {
        "path": "id",
        "sampleValue": "18f2a1c9d0"
      },
      {
        "path": "threadId",
        "sampleValue": "18f2a1c9d0"
      },
      {
        "path": "labelIds",
        "sampleValue": "[\"SENT\"]"
      }
    ]
  }
}

{
  "type": "about:blank",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "instance": "<string>",
  "code": "<string>",
  "errors": [
    {
      "field": "<string>",
      "message": "<string>"
    }
  ]
}

{
  "type": "about:blank",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "instance": "<string>",
  "code": "<string>",
  "errors": [
    {
      "field": "<string>",
      "message": "<string>"
    }
  ]
}

{
  "type": "about:blank",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "instance": "<string>",
  "code": "<string>",
  "errors": [
    {
      "field": "<string>",
      "message": "<string>"
    }
  ]
}

{
  "type": "about:blank",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "instance": "<string>",
  "code": "<string>",
  "errors": [
    {
      "field": "<string>",
      "message": "<string>"
    }
  ]
}

{
  "type": "about:blank",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "instance": "<string>",
  "code": "<string>",
  "errors": [
    {
      "field": "<string>",
      "message": "<string>"
    }
  ]
}

Integrations

Probe an MCP tool (runs the real action)

⚠️ This runs the real action. An MCP tool has no output schema and no sandbox, so to learn which fields it returns (for choosing allowed_fields when you freeze it) we execute the tool once against your connected MCP endpoint with the args you supply. Because it performs a live action, you must set acknowledge_execution: true (422 otherwise). On success it returns the response flattened to dotted field paths with sample values and a PII class per field; on a provider failure it returns empty results with an error class instead of an HTTP error. Returns 409 if the connector isn’t connected.

POST

/

integrations

/

{kind}

/

tools

/

{tool}

/

probe

Error

A valid request URL is required to generate request examples

{
  "data": {
    "durationMs": 1840,
    "leaves": [
      {
        "path": "id",
        "sampleValue": "18f2a1c9d0"
      },
      {
        "path": "threadId",
        "sampleValue": "18f2a1c9d0"
      },
      {
        "path": "labelIds",
        "sampleValue": "[\"SENT\"]"
      }
    ]
  }
}

{
  "type": "about:blank",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "instance": "<string>",
  "code": "<string>",
  "errors": [
    {
      "field": "<string>",
      "message": "<string>"
    }
  ]
}

{
  "type": "about:blank",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "instance": "<string>",
  "code": "<string>",
  "errors": [
    {
      "field": "<string>",
      "message": "<string>"
    }
  ]
}

{
  "type": "about:blank",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "instance": "<string>",
  "code": "<string>",
  "errors": [
    {
      "field": "<string>",
      "message": "<string>"
    }
  ]
}

{
  "type": "about:blank",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "instance": "<string>",
  "code": "<string>",
  "errors": [
    {
      "field": "<string>",
      "message": "<string>"
    }
  ]
}

{
  "type": "about:blank",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "instance": "<string>",
  "code": "<string>",
  "errors": [
    {
      "field": "<string>",
      "message": "<string>"
    }
  ]
}

Authorizations

Authorization

string

header

required

Flowyte secret API key (Authorization: Bearer flowyte_sk_live_…). Scope-gated; is scoped to your organization — a key can never reach another tenant. The listed scopes in each operation's apiKey requirement are the scopes that key must hold. The tokenUrl is nominal: keys are minted in the dashboard.

FlowClient Credentials

Token URL: /api/v1/api-keys

Scopes1

integrations:write

Discover schemas, set data scoping, and disconnect a connection.

Path Parameters

kind

enum<string>

required

The integration provider (connector). One of the supported connector slugs: native providers (google_calendar, google_sheets, calendly, hubspot, ``, square, opentable, shopify), SQL databases (postgres, mysql), the universal Zapier MCP fallback (zapier), or Composio (composio).

Available options:

google_calendar,

google_sheets,

calendly,

hubspot,

square,

opentable,

shopify,

postgres,

mysql,

zapier,

composio

tool

string

required

The equipped MCP tool name to probe.

Body

application/json

acknowledge_execution

boolean

required

MUST be true — an explicit acknowledgement that this EXECUTES the real Zapier action.

args

object

The arguments to run the tool with (a representative sample).

Response

The flattened response leaves (or an errorClass on a provider failure).

data

object

Show child attributes