Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.gildea.ai/llms.txt

Use this file to discover all available pages before exploring further.

All errors follow a consistent envelope format.

​
Error response shape

{
  "error": {
    "code": "not_found",
    "message": "Signal '0001f3a7b9c8d4e5f6a7b8c9d0e1f2a3b4c5d6e7' not found",
    "status": 404
  }
}
FieldTypeDescription
codestringMachine-readable error code
messagestringHuman-readable description
statusintegerHTTP status code

​
Error codes

StatusCodeDescription
400bad_requestInvalid request parameters
401unauthorizedInvalid or missing API key
403forbiddenInsufficient permissions
404not_foundResource not found
409conflictResource already exists (e.g. duplicate API key)
422—Request validation error (FastAPI)
429rate_limit_exceededRate limit exceeded (check Retry-After header)

​
Handling errors

from gildea_sdk import Gildea, RateLimitError, APIError

client = Gildea()
try:
    client.signals.list(q="AI")
except RateLimitError as e:
    time.sleep(e.retry_after or 60)
except APIError as e:
    print(f"Error ({e.status}): {e}")