Docs
Developer Console
OAuth

Revoke a token

POST/v1/oauth/revoke

Revoke a connection access token. For a public application, send its client_id in the form body. For a confidential application, authenticate with HTTP Basic using client_id:client_secret. Use the application the token belongs to. The endpoint returns 200 whether or not the token was valid. The connection itself stays; revoke it from the console to delete its saved sign-in.

Authorization

clientBasic
AuthorizationBasic <token>

client_id:client_secret for confidential applications.

In: header

Request Body

application/x-www-form-urlencoded

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

curl -X POST "https://example.com/v1/oauth/revoke" \  -H "Content-Type: application/x-www-form-urlencoded" \  -d 'token=string'
Empty

Exchange a code for a token POST

Exchanges an authorization code for a connection access token. If your application is public, send `client_id` in the form body, plus the PKCE `code_verifier` when you sent a `code_challenge` on the auth link. If it's confidential, authenticate with HTTP Basic `client_id:client_secret`. The token is long-lived and doesn't refresh; issuing a new one for the same connection revokes the previous one. An invalid, expired, or used code returns `400 invalid_grant`.

Create an execution POST

Starts an execution on the connection identified by your bearer access token and returns it as `QUEUED`. Send `Idempotency-Key` (1–255 characters) and reuse it with the same request body and connection on retries to retrieve the original execution. The same key with a different body returns `409 IDEMPOTENCY_KEY_REUSED`. If the connection needs the user to sign in again, you'll get `409 CONNECTION_REAUTHORIZATION_REQUIRED`; if your credit balance is empty, `402 INSUFFICIENT_CREDITS`. Use the returned `execution.id` to poll `GET /v1/applications/{applicationId}/executions/{executionId}` with the same access token until its `status` is `COMPLETED`, which means it succeeded and `result` is set, or `FAILED`, where `terminal.status` names the reason.