{"revision":"0ed62d2c742f8e20","language":"en","entry":{"id":"canary-page","kind":"endpoint","group":"orgs","title":"Open the warrant canary","method":"GET","path":"/canary","paths":[],"summary":"Check the warrant canary’s signature in the reader’s browser.","response":"A page that reads GET /v1/canary and checks the latest statement in the browser: its text, its date, the signer’s key and card, the log and its witnesses.","parameters":[{"name":"lang","description":"en or it. English is the default.","in":"query","required":false}],"sample":"/canary","access":"public","base":"directory","notes":["Every page of Veil links here from its footer, with the date of the latest statement, or a warning when it is stale or missing."],"errors":["429 rate_limited","500 internal_error","503 busy"],"related":["canary","verify-page"],"sections":[{"kind":"code","language":"shell","code":"curl -fsS 'https://veil.rip/canary'"}],"live":false,"responses":[{"status":200,"contentType":"text/html","description":"A page that reads GET /v1/canary and checks the latest statement in the browser: its text, its date, the signer’s key and card, the log and its witnesses.","fields":[]}],"responseObjects":[],"errorFormat":"json","errorDetails":[{"status":429,"code":"rate_limited","description":"An anonymous, signed-request or API-key allowance was exceeded.","action":"Wait at least `Retry-After` seconds. Share a queue and retry budget across your workers.","scope":"common"},{"status":500,"code":"internal_error","description":"An unexpected server error occurred. Internal details are not returned.","action":"Retry reads with bounded backoff. Check write results before sending a new signed operation.","scope":"common"},{"status":503,"code":"busy","description":"The application has reached a temporary concurrency or database limit.","action":"Wait `Retry-After` seconds and retry with bounded backoff.","scope":"common"}],"responseHeaders":[{"name":"Content-Type","value":"text/html","description":"Use the declared media type before choosing a parser."},{"name":"Date","value":"HTTP date","description":"Server time. Compare it with your clock when signing requests."},{"name":"Retry-After","value":"integer seconds, on rate_limited or busy","description":"Wait at least this long before retrying. Other 429/503 codes do not necessarily include it."}],"documentationUrl":"https://veil.rip/docs/canary-page","supportsBrowserFetch":false,"browserMode":"navigation"}}