Attempt remote revocation when possible, then synchronously mark the local connection revoked and destroy access and refresh token ciphertext before returning 204.
Dashboard session cookie; POST mutations also require X-CX-Request: 1.
admin
Not allowed
Parameters
Name
In
Type
Required
Description
workspace_id
path
string
Yes
—
connection_id
path
string
Yes
—
Request body
This operation has no request body.
Example
cURL
curl --request POST 'https://operade.ai/api/v1/workspaces/ws_demo/google-sheets/connections/gconn_example/revoke' --cookie 'cx_session=YOUR_SESSION_COOKIE' --header 'X-CX-Request: 1'
Responses
Status
Description
Content
4XX
Handled client error
application/json: ErrorResponse
204
Successful Response
No body
4XX application/json response schema
Field path
Type
Reference
Format
Nullable
Required
Enum
Description
$
object
ErrorResponse
—
No
Yes
—
—
error
object
ErrorItem
—
No
Yes
—
—
error.code
string
—
—
No
Yes
—
—
error.details
object
—
—
No
No
—
—
error.message
string
—
—
No
Yes
—
—
Response example
HTTP
HTTP 204
This response has no body.
Errors
Reviewed common and route-declared errors are summarized here; the list is not exhaustive. Start with the distributed error index to find each code's canonical domain page.
Status
Code
Description
401
unauthenticated
Authentication is missing, invalid, or revoked.
403
forbidden
Only a workspace admin or owner can revoke Google connections.
404
not_found
The requested Google connection was not found.
409
conflict
The Google connection was already revoked or changed concurrently.
503
google_integration_not_configured
The Google Sheets integration is disabled or incomplete.
