For AI agents: this page is also available as Markdown at https://docs.refabric.com/api-reference/platform/reference-data/list-error-codes.md, and the index of every page is https://docs.refabric.com/llms.txt.
Platform API › Reference data
List error codes
Every public error code with its type, HTTP status, meaning and fix.
https://api.refabric.com/v1/errorsimport requests
url = "https://api.refabric.com/v1/errors"
response = requests.get(url)
print(response.json()){
"items": []
}Authentication. No key: the reference is the same for every reader and shows nothing of an account.
Common use cases
- Map each error
codeto what your integration does next.
See also
GET /v1/account/metrics
Authorization
No key needed.
Parameters
Header parameters
- stringoptional
The contract version you wrote against (a date). Absent: the current version.
format: date
- stringoptional
Your own id for this request; we answer it back under X-Client-Request-ID.
max length 128
Response
200 — Done: the answer is in the body.
- array<object>required
The codes.
- stringrequired
The code.
Example:
invalid_request - stringrequired
What kind of failure an error is — each code belongs to one.
Values
invalid_request— The request cannot be used as sent; fix it and send again.authentication— No valid API key was sent.permission— Your key or your plan does not allow this.not_found— Nothing of yours has this address, or it was removed.conflict— The request conflicts with the current state of what it names.insufficient_credits— Your balance does not cover this request.rate_limited— Too many requests; wait and retry.content_refused— The inputs were refused.processing_failed— The job ran and failed.internal— Something went wrong on our side.warning— Not an error: a note on a job that succeeded.
Example:
invalid_request - integerrequired
The status it is answered with.
Example:
422 - stringrequired
What it means.
Example:
A field is missing. - stringrequired
How to fix it.
Example:
Correct the field and send again. - booleanrequired
Whether the same request may succeed later.
Example:
false - stringoptionalnullable
The code's page in the docs. Every error answered with this code carries the same link in its
docs; absent when the code has no docs page. - array<object>optionalnullable
The facts its
ctxmay carry.- stringrequired
The key in
ctx.Example:
required - stringrequired
Its JSON type.
Example:
integer - stringrequired
What it says.
Example:
The credits needed.
- 401 — No valid API key was sent.
- 403 — Your key or your plan does not allow this.
- 429 — Too many requests: wait for the number of seconds in the Retry-After header.
- 500 — Something went wrong on our side; retry, and quote the request id if it keeps happening.