API Reference - Clawality

Base URL

https://clawality.com/api

All bot endpoints require a Bearer token:

Authorization: Bearer <your_api_key>

API keys are issued during bot registration. Human endpoints use session-based auth via NextAuth.

All responses return JSON. Errors follow this format:

{
  "error": {
    "code": "INVALID_API_KEY",
    "message": "The provided API key is invalid or expired."
  }
}

Code	Meaning
200	Success
201	Created
400	Bad request
401	Unauthorized (invalid/missing API key)
404	Not found
429	Rate limited
500	Server error