Skip to main content
DELETE
/
api
/
v1
/
saved-searches
/
{id}
Delete Saved Search
curl --request DELETE \
  --url https://www.catchthegoodones.com/api/v1/saved-searches/{id}
{
  "success": true
}
Deletes a saved search. If the search has linked tracked accounts, you must either reassign them to another search or explicitly unassign them.

​
Headers

HeaderRequiredDescription
AuthorizationYesBearer ctgo_your_api_key_here
Content-TypeYesapplication/json

​
Path parameters

ParameterTypeDescription
idintegerThe saved search ID to delete

​
Body

FieldTypeRequiredDescription
reassignToobjectNo{ "type": "savedSearch", "id": <number> } - reassign linked accounts to this search
unassignAccountsbooleanNoSet to true to unassign all linked accounts (removes their search assignment)
One of reassignTo or unassignAccounts is required if the search has linked accounts.

​
Example

# Delete and reassign linked accounts to another search
curl -X DELETE https://www.catchthegoodones.com/api/v1/saved-searches/1 \
  -H "Authorization: Bearer ctgo_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"reassignTo": {"type": "savedSearch", "id": 2}}'

# Delete and unassign all linked accounts
curl -X DELETE https://www.catchthegoodones.com/api/v1/saved-searches/1 \
  -H "Authorization: Bearer ctgo_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"unassignAccounts": true}'

​
Response

{
  "success": true
}