Delete a staff member

Detaches them from every event that listed them, as lead, support, or on any invite list.

A row that belongs to a signed-in member (hasAccount: true) can’t be deleted this way — it is recreated on sight — so the request returns 409 staff_has_account. Remove the person from the organisation instead.

DELETE/api/v1/staff/{id}

Authorization

AuthorizationBearer token (bloomcount_...) · headerrequired

Path parameters

idstringrequired

Responses

200Deleted

deletedbooleanrequired

detachedEventsintegerrequired

How many events this person was removed from.

401Missing or invalid API key, or revoked / expired.

errorstringrequired

403Authenticated, but the key lacks the required scope or the tenant has no API access.

errorstringrequired

404The requested resource doesn't exist or belongs to a different tenant.

errorstringrequired

409The request is well formed, but it conflicts with the current state: a name already taken, a row the app protects (the hidden Default supplier, a preset colour or category), or a staff member who has an account.

errorstringrequired

429Per-minute rate limit (60/min) or per-month cap exceeded.

errorstringrequired

Try it

Server

Base URLCustom base URLOverrides the selected server when set.

Authorization

Bearer token (bloomcount_...)Remember on this deviceInclude my values in samples

Parameters

idpath*

Request

curl -X DELETE "https://app.bloomcount.com/api/v1/staff/stf_r4t7v2x9z1b6n3q8w5y0m2k7" \
  -H "Authorization: Bearer YOUR_TOKEN"

const response = await fetch("https://app.bloomcount.com/api/v1/staff/stf_r4t7v2x9z1b6n3q8w5y0m2k7", {
  method: "DELETE",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN"
  }
});

import requests

response = requests.delete(
    "https://app.bloomcount.com/api/v1/staff/stf_r4t7v2x9z1b6n3q8w5y0m2k7",
    headers={
        "Authorization": "Bearer YOUR_TOKEN"
    },
)

Response

{
  "deleted": true,
  "detachedEvents": 4
}

{
  "error": "string"
}

{
  "error": "string"
}

{
  "error": "string"
}

{
  "error": "string"
}

{
  "error": "string"
}