API v3 is live and in beta: expect possible malfunctions and breaking changes in the coming days. If you find a bug, please report it to your Sillage contact.

Remove a member

Remove one member from a list.

Removes one member from a list. The company or person itself is not deleted. On a monitored customer or prospect list, removing a member stops its monitoring through that list.

Smart lists are managed in the app; their members can't be added or removed through the API.

Route

DELETE/api/v3/partner/workspaces/{partner_workspace_id}/lists/{kind}/{list_id}/members/{member_id}

Path parameters

ParameterTypeDescription
partner_workspace_idstringYour own ID for the client workspace, as you chose it at creation. URL-encode it in the path.
kindstringcompany or profile. It matches the kind of the list.
list_idintegerID of the list.
member_idintegerID of the member, as returned by List members.

Example request

curl -X DELETE "https://api.getsillage.com/api/v3/partner/workspaces/ws_123/lists/company/12/members/301" \
  -H "Authorization: Bearer $SILLAGE_MASTER_KEY"

Success response

Status: 200 OK

{
  "data": {
    "id": 301,
    "deleted": true
  }
}

Response fields

FieldTypeDescription
data.idintegerID of the member that was removed.
data.deletedbooleanAlways true.

Errors

StatusMeaning
401The master key is missing or invalid.
404No workspace found for this partner_workspace_id, the list does not exist, or the member is not on it.
409The list is a smart list. Smart lists are managed in the app; their members can't be added or removed through the API.
422kind, list_id or member_id is not valid: detail is "Invalid URL parameters" and errors names the parameter.
429Rate limit exceeded.
500An unexpected server error occurred.

Error responses use RFC 9457 problem documents with Content-Type: application/problem+json. type is always about:blank; code tells one problem from another, detail says what went wrong this time, and errors names the field at fault.

On this page