nodestash
Companies

Delete a company

Permanently deletes a company. Contacts linked to this company will have their `company_id` set to `null`. This action cannot be undone.

DELETE
/companies/{id}
AuthorizationBearer <token>

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

In: header

Path Parameters

id*string

Company ID (prefixed with co_).

Match^co_

Response Body

application/json

application/json

application/json

curl -X DELETE "https://api.nodestash.io/v1/companies/co_7rT4mK9pQsVwXyZaB2cD4"
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"
  }
}