Base URL
Your API root is your Freeplay instance URL plus/api/v2/:
https://acme.freeplay.ai/api/v2).
Authentication
Freeplay authenticates requests using API keys, which you can manage athttps://app.freeplay.ai/settings/api-access.
Include your API key in the Authorization header:
Error Handling
Freeplay uses standard HTTP status codes:| Code | Meaning |
|---|---|
| 200 | Success |
| 400 | Bad request — check your request parameters |
| 401 | Unauthorized — invalid or missing API key |
| 500 | Server error — safe to retry |
Errors in the 400-499 range are client errors and won’t resolve with retries.
For 500 errors, retry up to 3 times with at least a 5-second delay between
attempts.