Errors

SimpleLinks returns standard HTTP status codes. The response body is JSON — usually either a single string message or an object with details.

Status codes

Code	Meaning	Typical cause
200	OK	Request succeeded. Body holds the data or a status string.
400	Bad Request	Missing required parameter, malformed body, or unknown action.
401	Unauthorized	API key missing, malformed, or wrong header.
403	Forbidden	Key was regenerated or Server is inactive / suspended.
404	Not Found	The lookup target does not exist (e.g. unlinked user).
429	Too Many Requests	Rate-limit exceeded. See Rate Limits.
500	Internal Server Error	Unhandled exception. Retry with backoff; report if persistent.

Body shape

Most failure responses are a JSON-encoded string with the error message:

"Missing id"

Some endpoints return a structured object — for example, updateOxideGroupsBulk:

{ "updated": 12, "errors": 3 }

Retry policy

• 4xx: do not retry. Fix the request.
• 429: back off using the Retry-After header (in seconds).
• 5xx: exponential backoff (1s, 2s, 4s, …) with at most 4 attempts.