Curator API: Delete a Connection
DELETE https://api.curator.io/v1.3/connections/CONNECTION_ID removes a social network connection from your Curator account. It only works when no source uses the connection. The request needs your API key, and your plan must include API access. Only HTTPS is supported.
Authentication
Send your Curator API key (find it in the Curator Dashboard) in one of three ways: as a query string (?api_key=API_KEY), as a Basic auth header with the API key as the username, or as a Bearer token (Authorization: Bearer API_KEY, with Bearer capitalised). You can only delete connections in the account the key belongs to.
Example request
curl -X DELETE "https://api.curator.io/v1.3/connections/CONNECTION_ID" \
-H "Authorization: Bearer API_KEY"Parameters
Parameter | Description |
|---|---|
| The connection's API ID (a UUID), from its |
Response
A successful delete returns:
{ "data": null, "meta": { "success": true, "message": "Connection deleted" } }If sources still use the connection, nothing is deleted and you get a 409. Delete those sources first with Curator API: Delete a Source. Deleting a connection removes it from Curator only; the access you granted on the network itself stays until you revoke it there.
Errors
Status | When | Body |
|---|---|---|
401 | The API key is missing or not valid. |
|
403 | Your plan does not include API access. |
|
403 | The connection belongs to another account. |
|
404 | No connection has that ID, or it was already deleted. |
|
409 | Sources still use the connection. Nothing was deleted. |
|
429 | When rate limiting is enabled, more than 60 requests per minute. |
|