POST Queue a test through the same durable delivery flow
/api/v1/notifications/destinations/{id}/test
CSRF protected and idempotent through Idempotency-Key. At most ten tests per hour across all destinations. An explicitly requested test may use a paused, verified destination.
CSRF protected and idempotent through Idempotency-Key. At most ten tests per hour across all destinations. An explicitly requested test may use a paused, verified destination.
Browser session: __Host-mb_session cookie.
Machine management credentials in Authorization: Bearer. Check the permissions (scopes) required by the operation.
When using a browser session for a mutation, send the current CSRF token in X-CSRF-Token with the same-site cookie. OAuth consent uses its documented form field.
Private API responses prohibit storage. Public OAuth metadata is cached for 300 seconds; live streams additionally prohibit transformation.
Content-Language
string; {"enum":["en","de"]}
Language of human-readable response text, resolved from Accept-Language or the documented browser preference. Technical codes and identifiers remain stable.
The default referrer policy is strict-origin-when-cross-origin. Provider-login responses use no-referrer to protect login parameters.
Vary
string
Responses vary by Accept-Language; browser-rendered responses can also vary by the preference cookie.
X-Content-Type-Options
JSON; {"const":"nosniff"}
The browser must use the declared content type.
X-Frame-Options
JSON; {"const":"DENY"}
The response must not be embedded in a frame.
X-Request-ID
string
Server-generated request identifier. Include this when reporting an error; inbound values are not trusted.
application/json
Field
Type and limits
Required
Meaning
$
object | object
Yes
—
$ (anyOf 1)
object
No
—
$ (anyOf 1).id
JSON
Yes
—
$ (anyOf 1).status
string
Yes
—
$ (anyOf 2)
object
No
—
$ (anyOf 2).id
string
Yes
—
$ (anyOf 2).status
string
Yes
—
Stable error codes
unauthorized
Header
Type and limits
Meaning
Cache-Control
string; {"pattern":"(?:^|,\\s*)no-store(?:,|$)"}
Private API responses prohibit storage. Public OAuth metadata is cached for 300 seconds; live streams additionally prohibit transformation.
Content-Language
string; {"enum":["en","de"]}
Language of human-readable response text, resolved from Accept-Language or the documented browser preference. Technical codes and identifiers remain stable.
The default referrer policy is strict-origin-when-cross-origin. Provider-login responses use no-referrer to protect login parameters.
Vary
string
Responses vary by Accept-Language; browser-rendered responses can also vary by the preference cookie.
X-Content-Type-Options
JSON; {"const":"nosniff"}
The browser must use the declared content type.
X-Frame-Options
JSON; {"const":"DENY"}
The response must not be embedded in a frame.
X-Request-ID
string
Server-generated request identifier. Include this when reporting an error; inbound values are not trusted.
application/problem+json
Field
Type and limits
Required
Meaning
$
Problem
Yes
—
$.code
string
Yes
Stable machine-readable error code
$.detail
string
Yes
Short localized explanation without internal error details
$.instance
string
Yes
Unique relative identifier /api/v1/requests/{request_id}; not a retrievable resource
$.message
string
Yes
Temporarily identical to detail for existing clients
$.message_key
string
Yes
Stable translation key for changing the displayed language without another request
$.message_params
object; {"additionalProperties":true}
Yes
Named, safely rendered message parameters; never arbitrary HTML
$.request_id
string; {"pattern":"^[0-9a-f]{32}$"}
Yes
Server-generated diagnostic identifier. It contains no login token or credential.
$.status
integer; {"maximum":599,"minimum":400}
Yes
—
$.title
string
Yes
Localized HTTP status title
$.type
string; {"const":"about:blank"}
Yes
—
Stable error codes
forbidden
Header
Type and limits
Meaning
Cache-Control
string; {"pattern":"(?:^|,\\s*)no-store(?:,|$)"}
Private API responses prohibit storage. Public OAuth metadata is cached for 300 seconds; live streams additionally prohibit transformation.
Content-Language
string; {"enum":["en","de"]}
Language of human-readable response text, resolved from Accept-Language or the documented browser preference. Technical codes and identifiers remain stable.
The default referrer policy is strict-origin-when-cross-origin. Provider-login responses use no-referrer to protect login parameters.
Vary
string
Responses vary by Accept-Language; browser-rendered responses can also vary by the preference cookie.
X-Content-Type-Options
JSON; {"const":"nosniff"}
The browser must use the declared content type.
X-Frame-Options
JSON; {"const":"DENY"}
The response must not be embedded in a frame.
X-Request-ID
string
Server-generated request identifier. Include this when reporting an error; inbound values are not trusted.
application/problem+json
Field
Type and limits
Required
Meaning
$
Problem
Yes
—
$.code
string
Yes
Stable machine-readable error code
$.detail
string
Yes
Short localized explanation without internal error details
$.instance
string
Yes
Unique relative identifier /api/v1/requests/{request_id}; not a retrievable resource
$.message
string
Yes
Temporarily identical to detail for existing clients
$.message_key
string
Yes
Stable translation key for changing the displayed language without another request
$.message_params
object; {"additionalProperties":true}
Yes
Named, safely rendered message parameters; never arbitrary HTML
$.request_id
string; {"pattern":"^[0-9a-f]{32}$"}
Yes
Server-generated diagnostic identifier. It contains no login token or credential.
$.status
integer; {"maximum":599,"minimum":400}
Yes
—
$.title
string
Yes
Localized HTTP status title
$.type
string; {"const":"about:blank"}
Yes
—
Stable error codes
not_found
Header
Type and limits
Meaning
Cache-Control
string; {"pattern":"(?:^|,\\s*)no-store(?:,|$)"}
Private API responses prohibit storage. Public OAuth metadata is cached for 300 seconds; live streams additionally prohibit transformation.
Content-Language
string; {"enum":["en","de"]}
Language of human-readable response text, resolved from Accept-Language or the documented browser preference. Technical codes and identifiers remain stable.
The default referrer policy is strict-origin-when-cross-origin. Provider-login responses use no-referrer to protect login parameters.
Vary
string
Responses vary by Accept-Language; browser-rendered responses can also vary by the preference cookie.
X-Content-Type-Options
JSON; {"const":"nosniff"}
The browser must use the declared content type.
X-Frame-Options
JSON; {"const":"DENY"}
The response must not be embedded in a frame.
X-Request-ID
string
Server-generated request identifier. Include this when reporting an error; inbound values are not trusted.
application/problem+json
Field
Type and limits
Required
Meaning
$
Problem
Yes
—
$.code
string
Yes
Stable machine-readable error code
$.detail
string
Yes
Short localized explanation without internal error details
$.instance
string
Yes
Unique relative identifier /api/v1/requests/{request_id}; not a retrievable resource
$.message
string
Yes
Temporarily identical to detail for existing clients
$.message_key
string
Yes
Stable translation key for changing the displayed language without another request
$.message_params
object; {"additionalProperties":true}
Yes
Named, safely rendered message parameters; never arbitrary HTML
$.request_id
string; {"pattern":"^[0-9a-f]{32}$"}
Yes
Server-generated diagnostic identifier. It contains no login token or credential.
$.status
integer; {"maximum":599,"minimum":400}
Yes
—
$.title
string
Yes
Localized HTTP status title
$.type
string; {"const":"about:blank"}
Yes
—
Stable error codes
idempotency_conflict
not_verified
Header
Type and limits
Meaning
Cache-Control
string; {"pattern":"(?:^|,\\s*)no-store(?:,|$)"}
Private API responses prohibit storage. Public OAuth metadata is cached for 300 seconds; live streams additionally prohibit transformation.
Content-Language
string; {"enum":["en","de"]}
Language of human-readable response text, resolved from Accept-Language or the documented browser preference. Technical codes and identifiers remain stable.
The default referrer policy is strict-origin-when-cross-origin. Provider-login responses use no-referrer to protect login parameters.
Vary
string
Responses vary by Accept-Language; browser-rendered responses can also vary by the preference cookie.
X-Content-Type-Options
JSON; {"const":"nosniff"}
The browser must use the declared content type.
X-Frame-Options
JSON; {"const":"DENY"}
The response must not be embedded in a frame.
X-Request-ID
string
Server-generated request identifier. Include this when reporting an error; inbound values are not trusted.
application/problem+json
Field
Type and limits
Required
Meaning
$
Problem
Yes
—
$.code
string
Yes
Stable machine-readable error code
$.detail
string
Yes
Short localized explanation without internal error details
$.instance
string
Yes
Unique relative identifier /api/v1/requests/{request_id}; not a retrievable resource
$.message
string
Yes
Temporarily identical to detail for existing clients
$.message_key
string
Yes
Stable translation key for changing the displayed language without another request
$.message_params
object; {"additionalProperties":true}
Yes
Named, safely rendered message parameters; never arbitrary HTML
$.request_id
string; {"pattern":"^[0-9a-f]{32}$"}
Yes
Server-generated diagnostic identifier. It contains no login token or credential.
$.status
integer; {"maximum":599,"minimum":400}
Yes
—
$.title
string
Yes
Localized HTTP status title
$.type
string; {"const":"about:blank"}
Yes
—
Stable error codes
invalid_destination
Header
Type and limits
Meaning
Cache-Control
string; {"pattern":"(?:^|,\\s*)no-store(?:,|$)"}
Private API responses prohibit storage. Public OAuth metadata is cached for 300 seconds; live streams additionally prohibit transformation.
Content-Language
string; {"enum":["en","de"]}
Language of human-readable response text, resolved from Accept-Language or the documented browser preference. Technical codes and identifiers remain stable.
The default referrer policy is strict-origin-when-cross-origin. Provider-login responses use no-referrer to protect login parameters.
Vary
string
Responses vary by Accept-Language; browser-rendered responses can also vary by the preference cookie.
X-Content-Type-Options
JSON; {"const":"nosniff"}
The browser must use the declared content type.
X-Frame-Options
JSON; {"const":"DENY"}
The response must not be embedded in a frame.
X-Request-ID
string
Server-generated request identifier. Include this when reporting an error; inbound values are not trusted.
application/problem+json
Field
Type and limits
Required
Meaning
$
Problem
Yes
—
$.code
string
Yes
Stable machine-readable error code
$.detail
string
Yes
Short localized explanation without internal error details
$.instance
string
Yes
Unique relative identifier /api/v1/requests/{request_id}; not a retrievable resource
$.message
string
Yes
Temporarily identical to detail for existing clients
$.message_key
string
Yes
Stable translation key for changing the displayed language without another request
$.message_params
object; {"additionalProperties":true}
Yes
Named, safely rendered message parameters; never arbitrary HTML
$.request_id
string; {"pattern":"^[0-9a-f]{32}$"}
Yes
Server-generated diagnostic identifier. It contains no login token or credential.
$.status
integer; {"maximum":599,"minimum":400}
Yes
—
$.title
string
Yes
Localized HTTP status title
$.type
string; {"const":"about:blank"}
Yes
—
Stable error codes
notification_test_limit
Header
Type and limits
Meaning
Cache-Control
string; {"pattern":"(?:^|,\\s*)no-store(?:,|$)"}
Private API responses prohibit storage. Public OAuth metadata is cached for 300 seconds; live streams additionally prohibit transformation.
Content-Language
string; {"enum":["en","de"]}
Language of human-readable response text, resolved from Accept-Language or the documented browser preference. Technical codes and identifiers remain stable.
The default referrer policy is strict-origin-when-cross-origin. Provider-login responses use no-referrer to protect login parameters.
Vary
string
Responses vary by Accept-Language; browser-rendered responses can also vary by the preference cookie.
X-Content-Type-Options
JSON; {"const":"nosniff"}
The browser must use the declared content type.
X-Frame-Options
JSON; {"const":"DENY"}
The response must not be embedded in a frame.
X-Request-ID
string
Server-generated request identifier. Include this when reporting an error; inbound values are not trusted.
application/problem+json
Field
Type and limits
Required
Meaning
$
Problem
Yes
—
$.code
string
Yes
Stable machine-readable error code
$.detail
string
Yes
Short localized explanation without internal error details
$.instance
string
Yes
Unique relative identifier /api/v1/requests/{request_id}; not a retrievable resource
$.message
string
Yes
Temporarily identical to detail for existing clients
$.message_key
string
Yes
Stable translation key for changing the displayed language without another request
$.message_params
object; {"additionalProperties":true}
Yes
Named, safely rendered message parameters; never arbitrary HTML
$.request_id
string; {"pattern":"^[0-9a-f]{32}$"}
Yes
Server-generated diagnostic identifier. It contains no login token or credential.
$.status
integer; {"maximum":599,"minimum":400}
Yes
—
$.title
string
Yes
Localized HTTP status title
$.type
string; {"const":"about:blank"}
Yes
—
Stable error codes
unavailable
Header
Type and limits
Meaning
Cache-Control
string; {"pattern":"(?:^|,\\s*)no-store(?:,|$)"}
Private API responses prohibit storage. Public OAuth metadata is cached for 300 seconds; live streams additionally prohibit transformation.
Content-Language
string; {"enum":["en","de"]}
Language of human-readable response text, resolved from Accept-Language or the documented browser preference. Technical codes and identifiers remain stable.
Save an Idempotency-Key before sending. Retry it only for the same target and unchanged request. A changed payload returns 409. Use this header only where the endpoint documents it.
Replace demo IDs, timestamps and placeholders with your own values. For a retry, keep the same IDs, time and content. These examples do not run requests on this page.
Keep login links, codes, cookies and keys private. Do not print them in logs or share them in support requests.
CSRF protected. revision protects concurrent changes. Changes increase the connection revision and cancel queued messages. Change an email address or Telegram chat through a new destination or a new connection proof.