Poll the status of an errand handoff.
GET
/errand/{errandKey}/status
const url = 'https://native-api.sudomimus.com/errand/example/status';const options = {method: 'GET'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url https://native-api.sudomimus.com/errand/example/statusPoll about every two seconds while the user completes the browser
handoff, or wait for confirmation in your own UI. No additional
authentication is required beyond errandKey. Unknown, malformed, and
expired keys all report EXPIRED. After COMPLETED, retry the original
direct-issue request once.
Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”errandKey
required
string
The errand.errandKey value from the 403 body.
Responses
Section titled “Responses”Current errand status.
Media typeapplication/json
object
status
required
string
Example
{ "status": "PENDING"}default
Section titled “default”Error response.
Media typeapplication/json
Error response body. Known failures may include a stable reason.
Some failures are status-only and have an empty body. A missing,
malformed, or structurally invalid JSON body returns InvalidBody.
object
reason
Stable machine-readable reason code.
string
Examplegenerated
{ "reason": "example"}