- an answer, with or without people in it (an empty circle and an
UNRESOLVEDresolve included); 404 person_not_found;- a partial answer (the research of a requested type failed).
404 person_not_found is an error, and is charged: the job ran to its end./v1/job, /v1/balance and /v1/openapi.json are free.
A call that starts a job reserves from the balance, before the job starts:
- its price;
- on circle, edge and paths with
on_miss: RESEARCH,max_tokenson top (2when absent).
402 insufficient_balance; an account with no billing account yet, 402 billing_account_missing (creating the first API key opens it).
On the answers of a call that reserved, except a 503 whose reservation was returned:
X-Orbb-Reservedcarries the tokens the call reserved;X-Orbb-Balancecarries the tokens available after the reservation.
/v1/balance reads the balance; its low_balance is true when less than 25 tokens are available.