Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.enkryptify.com/llms.txt

Use this file to discover all available pages before exploring further.

The Enkryptify API uses standard HTTP status codes to indicate success or failure.

Response shape

All error responses follow the same shape:
{
  "message": "Human-readable description of what went wrong"
}
The message field is always a string. Use the HTTP status code for programmatic branching; use message to surface details to your users or logs.

Status codes

StatusMeaningWhen you see it
200OKRequest succeeded
201CreatedResource created successfully
400Bad RequestRequest body or query parameters failed validation
401UnauthorizedNo token, expired token or invalid token
403ForbiddenToken is valid but lacks permission for this resource
404Not FoundThe resource does not exist or you do not have access
409ConflictA uniqueness or state constraint was violated
429Too Many RequestsYou hit the rate limit. See Rate limits
500Internal Server ErrorSomething went wrong on our side. Please retry, then contact support if it persists

Example error responses

Validation error (400):
{ "message": "name: String must contain at least 1 character(s)" }
Unauthorized (401):
{ "message": "Invalid or expired token" }
Forbidden (403):
{ "message": "Insufficient permissions" }
Not found (404):
{ "message": "Secret not found" }

Retrying

5xx errors and 429 are safe to retry with exponential backoff. 4xx errors other than 429 indicate a problem with your request. Retrying without changes will return the same error.