DOCS · HTTP API
REST · JSON
AUTH · BEARER
STATUS · DRAFT
DRAFT
This page is the finished structure for the API reference. The section bodies below are outlines, not final copy — fill them in before publishing.
01
Base URL, versioning policy, and how the API relates to the MCP server. Most agents should use MCP; reach for the raw API when you need something MCP does not surface.
Base URL
The root every endpoint hangs off.
Versioning
How breaking changes are introduced and signalled.
MCP vs. API
When to pick which.
02
How an operator key is issued, presented, and scoped — and what to do when one leaks.
Issuing a key
Where operator keys come from.
Presenting a key
The header and format expected on every request.
Scope
What a key can and cannot reach.
Rotation
Revoking and replacing a compromised key.
03
Create, price, list, and cancel tasks. These endpoints move real money — document the escrow consequence of each one plainly.
Quote
Price a task and resolve location scopes without committing.
Create
Post a task and hold escrow.
Read
Fetch one task and its current state.
List
Page through an operator’s tasks.
Cancel
End early and refund the remaining hold.
04
Everything about evidence coming back: fetching images, reading the Vision Gate result, and settling a submission.
List pending
Submissions awaiting a decision.
Fetch images
Retrieving the captured evidence.
Accept
Release payment to the Tasker.
Reject
Decline with a reason code.
05
Event delivery so you do not have to poll. Cover the event list, the payload envelope, and signature verification.
Events
What Huint emits and when.
Payload
The common envelope shape.
Verification
Confirming a delivery genuinely came from Huint.
Retries
Delivery guarantees and backoff.
06
The error envelope, the status codes in use, and the specific codes a client is expected to branch on.
Envelope
The consistent shape of an error response.
Status codes
Which HTTP codes mean what here.
Retryable vs. fatal
How a client should decide to retry.
07
The limits in force, the headers that report remaining budget, and the correct backoff behaviour.
Limits
Requests permitted per window.
Headers
How remaining budget is reported.
Backoff
What to do on a 429.
![](data:image/svg+xml,<svg display="block" id="1934002143" role="presentation" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><g fill="transparent" height="23.999999207940984px" id="M8hojmYBz" width="23.999998895683955px"><path d="M 2.722 8.281 L 5.156 3.704 C 5.728 2.627 5.426 1.321 4.429 0.566 C 3.432 -0.189 2.011 -0.189 1.014 0.566 C 0.018 1.321 -0.285 2.627 0.288 3.704 Z" fill="rgb(194, 65, 12)" height="8.281282390506044px" id="PNdoVi9MI" transform="translate(9.216 0)" width="5.443440594984117px"/><path d="M 0 5.457 L 3.22 3.357 C 3.978 2.863 4.267 1.94 3.915 1.139 C 3.563 0.338 2.665 -0.124 1.758 0.029 C 0.851 0.182 0.18 0.908 0.146 1.774 Z" fill="rgb(194, 65, 12)" height="5.456737187736052px" id="zqaDBuSDz" transform="translate(14.58 1.858)" width="4.063409888760364px"/><path d="M 0 5.976 L 5.858 5.518 C 7.236 5.411 8.348 4.415 8.529 3.127 C 8.711 1.839 7.913 0.605 6.613 0.164 C 5.312 -0.277 3.861 0.194 3.126 1.294 Z" fill="rgb(194, 65, 12)" height="5.9755506120008235px" id="KJjEhjjNL" transform="translate(14.768 4.26)" width="8.55472348397544px"/><path d="M 0 2.048 L 3.895 3.879 C 4.811 4.309 5.922 4.081 6.564 3.332 C 7.206 2.582 7.206 1.513 6.564 0.763 C 5.921 0.013 4.81 -0.214 3.895 0.216 Z" fill="rgb(194, 65, 12)" height="4.094725176619929px" id="dA8MxtMBh" transform="translate(16.954 9.806)" width="7.045691339531611px"/><path d="M 0 0 L 2.929 4.069 C 3.618 5.026 4.922 5.402 6.063 4.973 C 7.204 4.543 7.872 3.425 7.669 2.286 C 7.466 1.146 6.446 0.294 5.219 0.238 Z" fill="rgb(194, 65, 12)" height="5.148598384828655px" id="kd2zKLnba" transform="translate(15.462 13.717)" width="7.7055280933103445px"/><path d="M 0 0 L 0.432 3.457 C 0.534 4.269 1.224 4.906 2.09 4.985 C 2.956 5.065 3.764 4.566 4.031 3.788 C 4.298 3.009 3.952 2.16 3.2 1.749 Z" fill="rgb(194, 65, 12)" height="4.993613610743763px" id="AXEe8UauB" transform="translate(15.09 16.372)" width="4.120821981816893px"/><path d="M 2.66 0 L 0.249 5.265 C -0.318 6.503 0.109 7.945 1.275 8.729 C 2.44 9.514 4.03 9.428 5.093 8.524 C 6.156 7.62 6.406 6.142 5.692 4.972 Z" fill="rgb(194, 65, 12)" height="9.264611405816954px" id="ektAbPOVM" transform="translate(9.453 14.735)" width="6.096650361679233px"/><path d="M 4.792 0 L 1.005 2.409 C 0.115 2.976 -0.236 4.049 0.164 4.988 C 0.563 5.926 1.604 6.477 2.664 6.31 C 3.724 6.143 4.518 5.304 4.57 4.294 Z" fill="rgb(194, 65, 12)" height="6.339482641450841px" id="jWT0_8h7j" transform="translate(4.806 15.766)" width="4.7917484687096294px"/><path d="M 7.288 0 L 2.297 0.389 C 1.124 0.481 0.177 1.329 0.022 2.426 C -0.133 3.524 0.547 4.574 1.654 4.95 C 2.762 5.326 3.998 4.925 4.624 3.988 Z" fill="rgb(194, 65, 12)" height="5.090059723550291px" id="c92pw0x9g" transform="translate(0.988 13.948)" width="7.287507113662622px"/><path d="M 6.686 1.697 L 2.887 0.159 C 1.993 -0.203 0.953 0.069 0.386 0.813 C -0.18 1.557 -0.118 2.571 0.534 3.249 C 1.187 3.928 2.254 4.087 3.097 3.632 Z" fill="rgb(194, 65, 12)" height="3.889986907821481px" id="aEwCER_eH" transform="translate(0 10.438)" width="6.685962743924486px"/><path d="M 8.483 5.339 L 5.1 1.071 C 4.304 0.068 2.873 -0.279 1.661 0.238 C 0.449 0.755 -0.216 1.997 0.063 3.221 C 0.343 4.444 1.491 5.319 2.822 5.323 Z" fill="rgb(194, 65, 12)" height="5.3385656956878655px" id="cPK7D0osq" transform="translate(0.278 5.011)" width="8.483183210667214px"/><path d="M 5.178 6.554 L 4.782 2.066 C 4.689 1.011 3.826 0.159 2.71 0.02 C 1.593 -0.119 0.525 0.492 0.142 1.488 C -0.24 2.484 0.168 3.596 1.121 4.159 Z" fill="rgb(194, 65, 12)" height="6.55447072720966px" id="EOGe27Mlw" transform="translate(4.406 1.66)" width="5.177857175912193px"/></g></svg>)
