Curator API: Delete a Connection
DELETE https://api.curator.io/v1.2/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). You can only delete connections in the account the key belongs to.
Example request
curl -X DELETE "https://api.curator.io/v1.2/connections/CONNECTION_ID?api_key=API_KEY"Parameters
Parameter | Description |
|---|---|
| The connection's API ID (a UUID), from its |
Response
A successful delete returns a 200:
{ "success": true, "message": "Connection deleted" }If sources still use the connection, nothing is deleted and the response is still a 200, so check success:
{ "success": false, "message": "There are currently 2 source(s) using this connection" }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 |
|---|---|---|
200 | Sources still use the connection. Nothing was deleted. |
|
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. |
|
429 | When rate limiting is enabled, more than 60 requests per minute. |
|