POST /api-keys/accounts/:account_id
Creates a new API key for the specified account.
Base URL: https://api.geocerta.io
Sandbox URL: https://api-staging.geocerta.io
Authentication required. Include your API key in the
api-keyheader. See Authentication.
Endpoint
POST /api-keys/accounts/:account_idContent-Type: application/json
| Parameter | Description |
|---|---|
account_id | The _id of the account to create the key for |
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
name | string | Yes | A label for the new key (3–100 characters) |
Response
201 Created — returns the new key value. Store it securely — it will not be shown again.
Errors
| Status | Message | Cause |
|---|---|---|
400 | Bad Request | Missing or invalid request body |
401 | Unauthorized | Missing or invalid API key |
403 | Forbidden | The account does not belong to you |
404 | Account not found | No account exists with the given account_id |
Example
curl -X POST "https://api.geocerta.io/api-keys/accounts/66f3a1b2c4e5d8f9a1b2c4e5" \
-H "api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"name": "Production Key"}'