nodestash
Contacts

Delete a contact

Permanently deletes a contact. This action cannot be undone.

DELETE
/contacts/{id}

Authorization

apiKey
AuthorizationBearer <token>

API key from your nodestash dashboard. Pass as a Bearer token in the Authorization header.

In: header

Path Parameters

id*string

Contact ID (prefixed with ct_).

Match^ct_

Response Body

application/json

application/json

application/json

curl -X DELETE "https://api.nodestash.io/v1/contacts/ct_5hJ3kM9pQrVwXyZaB2cD4"
Empty
{
  "error": {
    "code": "INVALID_API_KEY",
    "message": "Missing or invalid Authorization header"
  },
  "meta": {
    "request_id": "req_abc123def456"
  }
}
{
  "error": {
    "code": "NOT_FOUND",
    "message": "Contact not found"
  },
  "meta": {
    "request_id": "req_abc123def456"
  }
}
{
  "error": {
    "code": "RATE_LIMITED",
    "message": "Rate limit exceeded"
  },
  "meta": {
    "request_id": "req_abc123def456"
  }
}

Create a new contact

Creates a new contact in the authenticated workspace. If an `email` is provided it must be unique within the workspace. All fields are optional — at minimum you should provide an email or a name so the contact is identifiable.

Get a contact

Retrieves a single contact by ID. Use the `include` parameter to embed related resources.