The error format and status codes the Gensiv API returns.
Errors return a JSON body with message, why and fix:
{
"message": "Invalid API key",
"why": "The key is unknown, revoked or expired",
"fix": "Create a new key in Settings > API keys and send it in the x-api-key header"
}| Status | Meaning |
|---|---|
400 | A query parameter is invalid; the body names the field |
401 | No key, or the key is unknown, revoked or expired |
402 | The workspace plan does not include API access (Lite or no plan), or a plan limit or credit balance blocks the change |
403 | The key is read-only and the endpoint changes data; create a key with Allow changes |
404 | The brand or item is not in the key's workspace |
429 | The key went over 120 requests a minute |
500 | Something went wrong on our side; try again, and contact support if it keeps happening |
A 402 body also carries plan and recommended, the smallest plan that includes API access.
Rate limits
How many requests a Gensiv API key can send and what happens when it goes over.
List brands GET
List the workspace's brands and the active brand. With a session, lists the active workspace's brands. With an API key, lists the brands of the key's workspace and returns the first brand as active.