Common API Error Codes

This document contains common API error codes and what each code typically means in DocStudio.

Code	Error	When it happens
400	Bad request	Request data is invalid or doesn’t match the API docs. The response can include a detailed issue description.
401	Unauthorized	Auth token is invalid, incorrect, or expired.
402	Payment Required	Billing denies functionality due to missing payment or plan restrictions.
403	Forbidden	The caller doesn’t have access or permissions for the requested entity. The response can include a detailed issue description.
404	Not found	The requested entity doesn’t exist or was deleted (hard delete).
409	Conflict	Rare. Appears when two entities conflict. Usually retried, so users don’t see it.
410	Entity gone	The requested entity was deleted (soft delete). Example: a template was deleted while being processed.
422	Unprocessable entity	The requested entity can’t be processed. Example: approve/reject the same envelope twice.
425	Too early	The request was sent too early. Example: the endpoint enforces a minimum time period between requests.
429	Too many requests	Too many requests were sent to the endpoint and you exceeded the rate limits.