A valid request URL is required to generate request examples{
"ok": true,
"status": 200
}{
"error": {
"code": "forbidden",
"message": "your role does not allow this action"
}
}{
"error": {
"code": "forbidden",
"message": "your role does not allow this action"
}
}{
"error": {
"code": "forbidden",
"message": "your role does not allow this action"
}
}{
"error": {
"code": "forbidden",
"message": "your role does not allow this action"
}
}Send a test alert
Requires alerts:manage. Sends one message now and answers with what the destination said.
It answers 200 whatever came back, and ok is the field to read. A 502 here would leave a screen unable to tell “we could not run the test” apart from “the test ran and the destination refused it”, which is the only thing a test is for. It writes no delivery record either: a test is not one of the five facts, and deduplicating it would mean the second press of the button silently did nothing.
A valid request URL is required to generate request examples{
"ok": true,
"status": 200
}{
"error": {
"code": "forbidden",
"message": "your role does not allow this action"
}
}{
"error": {
"code": "forbidden",
"message": "your role does not allow this action"
}
}{
"error": {
"code": "forbidden",
"message": "your role does not allow this action"
}
}{
"error": {
"code": "forbidden",
"message": "your role does not allow this action"
}
}Autorizações
A staff session token, uk_st_…. Minted by sign-up, sign-in or the two-factor exchange. Only a 401 means it is spent; not_a_member (403) is about the organization named in X-Organization-Id and leaves the token good for the others.
Cabeçalhos
The organization the caller is acting on — the org_… code that appears in the panel URL. It identifies; the membership JOIN is what authorizes, so a forged code reads nothing: the answer is not_a_member (403), which does not mean the session is over. Absent, the session's default organization answers, or — if that membership was revoked while the session was open — any other one the caller still holds.
Parâmetros de caminho
The alert channel's id. An id from another organization matches no row and answers 404.
Resposta
The attempt, and what the destination answered. An email channel answers queued.