Read the status of the validation policy checks of a pull request or a revision

Reports every check the policy defines for the change agent of a pull request or a revision: one per stage, application and kind (the impacted tests, or one suite), what each covered and how it went, and one status rolled up over them. A revision's stage is judged by its latest request, so a check reads waiting from a newer request until that request's run starts. Computed on each call from the stage requests and the runs they started; it stores nothing. A gate sends its stage request, and once that is accepted names the stage and the head it reports on, then reads that stage's gate. A run counts as the deployment event counts it: the event's own runs and their automatic retries, not a person's rerun. Waivers come only from the labels sent with the stage's request. Once the pull request merged, landed gives the merge and what became of its mabl branch. Branch on error_code in an error body: invalid_request (400), feature_disabled and forbidden (403), and no_change_agent (404).

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
required

The workspace the change agent runs in

reference
object
required

The pull request or the revision, as the stage requests name it

string
enum
required

caller: a stage whose policy another client sent, whether its own request's or, for a stage not requested, the newest request's, reads cant_tell with untrusted_provider, and so does a check whose runs started from another client's request. A gate sends it. any: every sender the events route accepts

Allowed:
stages
array of objects
length ≤ 10

The stages to report, each once. Omitted for a pull request, every stage of the policy whose run belongs to a pull request, plus any requested stage the policy doesn't define. Omitted for a revision, the stages requested for it

stages
Responses

Language
Credentials
:
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json