Delete a personal notification

delete

https://api.doit.com/iam/v1/users/{userId}/notifications/{id}

Permanently deletes a personal notification config. Requires Users Manager (usersManager), the If-Match header, and the Idempotency-Key header. With dryRun=true the request goes through the same checks as a real delete without deleting anything. Deleting an id that no longer exists returns 404.
Reads are immediately consistent. After a completed delete (204 without X-Dry-Run: true), a GET of that notification returns 404.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

userId

string

required

length ≥ 1

The unique ID of the user. Must belong to the tenant resolved from the bearer token and optional X-Tenant-Id.

string

required

length ≥ 1

The unique ID of the notification config returned by create or list.

Query Params

dryRun

boolean

Defaults to false

If true, validates the request and returns the would-be result without applying it. The response then carries the X-Dry-Run header.

Headers

If-Match

string

required

The ETag of the current version, from a get, create or update response. A stale value returns 412; re-read the resource and retry with the new ETag.

Idempotency-Key

string

required

length between 1 and 255

Client-generated key (UUID v4 or ULID recommended). Retrying with the same key and request returns the stored response instead of repeating the operation; the key is kept for 24 hours.

Responses

Language

Credentials

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

*/*

application/problem+json

204No Content - Notification deleted, or validated when dryRun=true.

400Syntactically malformed request, missing required parameter, or unsupported parameter value.

401Missing or invalid credentials.

403Authenticated but not authorized to perform this request.

404The requested resource does not exist.

409The request conflicts with the current state of the resource.

412The If-Match value no longer matches the current version of the resource.

422The request is well-formed but a value is not accepted, such as an unknown permission name.

428The request is missing the required If-Match header.

500Unexpected server error.