API Keys
API Keys endpoints of the bizSupply API.
Last updated: 2026-07-21
GET /api/v1/api-keys
List all API keys for the authenticated user.
Responses
| Status | Description |
|---|---|
200 | List of API key metadata (no plaintext) |
401 | Authentication required |
POST /api/v1/api-keys
Create a new API key.
The plaintext key is returned only once in the response. Save it immediately — it cannot be retrieved again.
Request body
application/json→ApiKeyCreateRequest
Responses
| Status | Description |
|---|---|
201 | API key created |
400 | Invalid request body |
401 | Authentication required |
GET /api/v1/api-keys/{id}
Get a specific API key by ID.
Parameters
| Name | In | Required | Description |
|---|---|---|---|
id | path | yes | API key UUID. |
Responses
| Status | Description |
|---|---|
200 | API key metadata |
401 | Authentication required |
404 | API key not found |
DELETE /api/v1/api-keys/{id}
Revoke an API key.
Marks the key as REVOKED. It can no longer be used for authentication. This action cannot be undone.
Parameters
| Name | In | Required | Description |
|---|---|---|---|
id | path | yes | API key UUID to revoke. |
Responses
| Status | Description |
|---|---|
204 | API key revoked |
401 | Authentication required |
404 | API key not found |