Delete member

Remove a member from the organization by ID, email, phone, or name.

POST /member/delete

Delete member

cURL

curl --request POST \
  --url 'https://api.flashcat.cloud/member/delete?app_key=' \
  --header 'Content-Type: application/json' \
  --data '
{
  "member_id": 5068740052131
}
'

200

{
  "request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
  "data": {}
}

Restrictions

Aspect	Value
Rate limits	1,000 requests/minute; 50 requests/second per account
Permissions	Members Manage (organization)

Usage

• By default (is_force=false), the system checks whether the member is referenced by other resources (e.g., escalation rules, schedules). If references exist, the API returns error code ReferenceExist with the reference list in data.refs. Set is_force=true to skip the reference check and force delete.
• Members provisioned via SSO with sso_user_non_editable=true cannot be deleted through this API. Disable that SSO restriction first.
• This operation is recorded in the audit log.

Authorizations

app_key · string · query · required

App key issued from the Flashduty console under Account → APP Keys. Required on every public API call. Keep it secret — it grants the same access as the owning account.

Body

application/json

Delete member request (provide one of the lookup fields)

member_id · integer<uint64>

Member ID

member_name · string

Member name

email · string

Email address

phone · string

Phone number

country_code · string

Phone country code, used with phone

ref_id · string

External reference ID

is_force · boolean · default: false

Force delete. Defaults to false, which checks for references from escalation rules, schedules, etc. Set to true to skip the reference check and delete immediately

Response

200

application/json

Success

Success response envelope. On every 2xx response, request_id identifies the call (also mirrored in the Flashcat-Request-Id header) and data holds the endpoint-specific payload. Failure responses use a different shape — see ErrorResponse.

request_id · string · required

Unique ID for this request. Mirrored in the Flashcat-Request-Id response header. Include it when reporting issues.

Example:

"01HK8XQE3Z7JM2NTFQ5YJ8P9R4"

data · object · required

Empty response