Skip to main content
POST
Discover and connect. OAuth may return an authorization URL; anonymous and saved-credential connections need no setup page. Once ready, its tools are available in the owner’s Itoflow chats, not in the calling client.

Authorizations

Authorization
string
header
required

Itoflow access token issued for the Itoflow API.

Body

application/json
connectionId
string<uuid>
required

Connection ID returned by add or list.

Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
expectedVersion
integer
required

Latest connection version; refresh after connection_changed.

Required range: x <= 9007199254740991
bearerToken
string

Raw provider token, without the Bearer prefix. Omit to reuse a saved token. Treat it as a secret: do not paste it into chat, print it or commit it.

Required string length: 1 - 8192
Pattern: ^[\x21-\x7e\x80-\xff]+$

Response

Success

attemptId
string<uuid> | null
required
authorizationUrl
string | null
required
connection
object
required