Delete Default-App Credential

Remove a single auth credential from the org’s default app.

DELETE /api/v2/public/linked-account/default-app/auth-credentials/:key

cURL (API key)

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

200

{
  "success": true,
  "message": "Auth credential 'api_key' deleted successfully"
}

Remove a named credential key from the linked account’s default-app authTokens and invalidate the integration’s token cache.

Authentication

This endpoint accepts either authentication method.

Option 1 — API key

x-api-key · string

Your Refold API key. Find it in Settings → Credentials.

linked_account_id · string

The linked account to operate on. May also be passed as a query parameter.

Option 2 — Session token

Authorization · string

Session token for the linked account (the account is taken from the token).

Format: Bearer YOUR_SESSION_TOKEN

Path Parameters

key · string · required

The credential key name to remove.

Example: api_key

Response

200 OK

success · boolean

Whether the deletion succeeded.

message · string

Confirmation message.

404 Not Found

Returned when the key (or the default-app integration) does not exist.

200

{
  "success": true,
  "message": "Auth credential 'api_key' deleted successfully"
}

cURL (API key)

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