PATCH /api-keys/:id

Updates the name or status of an API key.

Base URL: https://api.geocerta.io

Sandbox URL: https://api-staging.geocerta.io

Authentication required. Include your API key in the api-key header. See Authentication.

Endpoint

PATCH /api-keys/:id

Content-Type: application/json

Path Parameters

Parameter	Type	Description
`id`	string	The API key ID

Request Body

All fields are optional. Only include the fields you want to update.

Field	Type	Description
`name`	string	Key display name (3–100 characters)
`status`	string	`active` or `revoked`

Response

200 OK — returns the updated API key.

Errors

Status	Message	Cause
`400`	Bad Request	Validation failed
`401`	Unauthorized	Missing or invalid API key
`403`	Forbidden	Key does not belong to your account
`404`	API key not found	Key does not exist

Example

curl -X PATCH "https://api.geocerta.io/api-keys/66f3a1b2c4e5d8f9a1b2c4e5" \
  -H "api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "status": "revoked" }'