Delete Connection

Delete a connection, revoking it with the provider first when the app supports that. Parent delegation cannot delete Embedded end-user or installation connections. A key deletes only the connections its creator may use: shared ones, and their own personal ones.

DEL

Path

Path parameters

stringrequired

The connection's id, from List Connections.

Headers

Optional headers

string

Optional. The id of the organization to act in. Leave it out to act in the API key's own organization. A key can also act in its child organizations, and, with "Use this key across all of your organizations" on, in every organization its creator can open in the app. List them with GET /v2/companies. Every response's X-Company-Id header names the organization it acted in. See Organizations.

Response fields

idstring

The id of the resource that was deleted.

Try this request

API Key

Request

curl --request DELETE \
  --url 'https://connect.mindcloud.co/v2/connections/Cn6vH3jW8qYt' \
  --header 'Authorization: Bearer $MINDCLOUD_API_TOKEN'

{
  "success": true,
  "data": {
    "id": "Cn6vH3jW8qYt"
  }
}

View as Markdown