API Overview

All API endpoints are under:

https://api-staging.enver-os.xyz/api/v1

Request format

Success:

{ "success": true, "data": { ... } }

Error:

{ "success": false, "error": "Description of the error" }

Code	Meaning
`200`	Success
`201`	Resource created
`400`	Bad request / validation error
`401`	Unauthenticated
`403`	Forbidden (wrong scope or IP)
`404`	Resource not found
`429`	Rate limited
`500`	Server error

The API is limited to 100 requests per minute per IP. Rate limit headers are included in every response:

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 95
X-RateLimit-Reset: 1724160000
Retry-After: 10

Method	Endpoint	Auth	Description
`POST`	`/envs`	`write:secrets`	Push encrypted secrets
`GET`	`/envs/share/:projectId`	`read:secrets`	Get shares for decryption
`DELETE`	`/envs/:projectId`	`write:secrets`	Delete environment secrets
`POST`	`/tokens`	Clerk session	Create API token
`GET`	`/tokens`	Clerk session	List tokens
`DELETE`	`/tokens/:id`	Clerk session	Revoke token
`GET`	`/projects/:id/members`	`read:secrets`	List project members
`POST`	`/projects/:id/members`	`admin`	Add member
`DELETE`	`/projects/:id/members/:email`	`admin`	Remove member
`GET`	`/auth/me`	Any valid token	Get current user