API Reference

All API requests require authentication using your platform API key. Include it in the Authorization header as a Bearer token.

You can find and regenerate your API key on the Settings page. Keys are prefixed with hk_ for easy identification.

curl -H "Authorization: Bearer hk_your_api_key" \
  https://api.hatcher.host/api/v1/agents

API usage is rate-limited per day based on your plan. Rate limit information is included in every response header.

Check the following response headers to monitor your usage:

All API responses follow a consistent JSON structure. Successful responses include a data field. Error responses include error and code fields.

{
  "success": true,
  "data": { ... }
}

{
  "success": false,
  "error": "Not found",
  "code": "NOT_FOUND"
}