Reference
API keys
Mint, list and revoke the credentials every other call is made with.
Mint, list and revoke the credentials every other call is made with.
The chapter that explains this resource, with runnable examples, is here — in Spanish for now.
| Method | Path | What it does |
|---|---|---|
GET | /api-keys | List API keys |
POST | /api-keys | Create API key (returns plaintext secret once) |
DELETE | /api-keys/{id} | Revoke API key |
GET /api-keys
List API keys
curl https://api.vitrinadev.com/api/v1/api-keys \
-H "Authorization: Bearer $VITRINA_KEY"Answers: 200 · 400 · 401 · 403 · 404 · 409 · 429
POST /api-keys
Create API key (returns plaintext secret once)
Body
| Field | Type | Required | Constraints |
|---|---|---|---|
name | string | yes | mín. 1, máx. 120 |
tenant_id | uuid | — | |
scopes | ai_agents:read \ | ai_agents:write \ | ai_agents:simulate \ |
expires_at | string | — | date-time |
curl -X POST https://api.vitrinadev.com/api/v1/api-keys \
-H "Authorization: Bearer $VITRINA_KEY" \
-H "Content-Type: application/json" \
-d '{ … }'Answers: 201 · 400 · 401 · 403 · 404 · 409 · 429
DELETE /api-keys/{id}
Revoke API key
| Parameter | In | Type | Required | Constraints |
|---|---|---|---|---|
id | path | uuid | yes |
curl -X DELETE https://api.vitrinadev.com/api/v1/api-keys/<id> \
-H "Authorization: Bearer $VITRINA_KEY"Answers: 204 · 400 · 401 · 403 · 404 · 409 · 429