Skip to main content
DELETE
/
api
/
v2
/
public
/
linked-account
/
integration
/
:slug
curl -X DELETE "https://app.refold.ai/api/v2/public/linked-account/integration/{slug}?linked_account_id=YOUR_LINKED_ACCOUNT_ID" \
  -H "x-api-key: YOUR_API_KEY"

{
  "_id": "6a3134fdc71d10070e78923e",
  "associated_org": "6500a1b2c3d4e5f6a7b8c9d0",
  "account_id": "user_12345",
  "environment": "test",
  "name": "Acme Inc.",
  "udf": [],
  "integrations": [],
  "createdAt": "2026-06-16T11:35:25.951Z",
  "updatedAt": "2026-06-16T11:36:00.774Z",
  "__v": 0
}
Remove an integration from a linked account. If auth_type is supplied, only that single connection within the integration is removed. When no connections remain, the workflow-side installation is deleted, related caches and dataslot keys are cleared, a webhook event is emitted, and a token-revoke job is enqueued for apps that support it. The updated linked account is returned. The call succeeds even if the integration was not present (the account is returned unchanged).

​
Authentication

​
x-api-key
string
required
Your Refold API key. Find it in Settings → Credentials.
​
linked_account_id
string
required
The linked account to operate on. May also be passed as a query parameter.

​
Path Parameters

​
slug
string
required
The application slug of the integration to remove.Example: hubspot

​
Query Parameters

​
linked_account_id
string
required
The linked account ID (required as header or query parameter).
​
auth_type
string
Remove only a single connection of this auth type (e.g. oauth2, keybased) instead of the whole integration.

​
Response

Returns the updated linked account.
​
_id
string
Internal record ID.
​
account_id
string
Your unique identifier for the account.
​
environment
string
Environment: test or live.
​
name
string
Display name.
​
integrations
array
Remaining integrations after removal.
{
  "_id": "6a3134fdc71d10070e78923e",
  "associated_org": "6500a1b2c3d4e5f6a7b8c9d0",
  "account_id": "user_12345",
  "environment": "test",
  "name": "Acme Inc.",
  "udf": [],
  "integrations": [],
  "createdAt": "2026-06-16T11:35:25.951Z",
  "updatedAt": "2026-06-16T11:36:00.774Z",
  "__v": 0
}

curl -X DELETE "https://app.refold.ai/api/v2/public/linked-account/integration/{slug}?linked_account_id=YOUR_LINKED_ACCOUNT_ID" \
  -H "x-api-key: YOUR_API_KEY"