Docspace

Buscar documentación…

Precios

Registrarse

Docspace

Buscar documentación…

Precios

Registrarse

Docspace

API

Introducción

Rotar clave API

Reemplaza una credencial existente por un secreto nuevo mientras conserva su asignación de proyecto y su etiqueta. Actualice su implementación antes de invalidar el valor anterior.

PUT

https://api.novaai.com/v1/api-keys/{api_key_id}

Authentication

Send a project-scoped NovaAI API key in the Authorization header using the Bearer scheme. Requests without valid credentials return 401 Unauthorized.

Authorization

string

requerido

Request properties

api_key_id

string

requerido

Identifier of the credential being rotated.

grace_period_seconds

integer

opcional

Optional overlap period before the previous secret is invalidated.

reason

string

opcional

Audit note explaining why the credential was rotated.

Response behavior

A successful PUT request returns a structured NovaAI resource response. Validate the returned identifier before persisting it, and handle 400 Bad Request for malformed input or 401 Unauthorized for invalid project credentials.

Integration notes

Use PUT /v1/api-keys/{api_key_id} from a trusted server environment. Keep your NovaAI API key out of browser bundles and pass only the data required for rotate api key in each request.

Validate inputs before sending the request, log the returned request identifier for troubleshooting, and use exponential backoff for temporary failures or rate-limit responses. Treat malformed payloads and authorization failures as non-retryable until corrected.

Error handling

Inspect the error type and code returned by NovaAI before retrying. Correct invalid parameters for 400 responses, refresh or replace credentials for 401 responses, and wait before retrying requests that are temporarily limited.

PUT/v1/api-keys/{api_key_id}

PUT /v1/api-keys/{api_key_id} HTTP/1.1
Authorization: Bearer NOVA_API_KEY
Content-Type: application/json

200Success response

{
  "id": "rotate_api_key_01",
  "object": "nova.resource",
  "status": "succeeded"
}

400Invalid request

{
  "error": {
    "message": "Invalid request",
    "type": "invalid_request_error",
    "code": "invalid_parameter"
  }
}

Rotar la clave API

Última actualización: 14 ago 2026

PUT/v1/api-keys/{api_key_id}

PUT /v1/api-keys/{api_key_id} HTTP/1.1
Authorization: Bearer NOVA_API_KEY
Content-Type: application/json

200Success response

{
  "id": "rotate_api_key_01",
  "object": "nova.resource",
  "status": "succeeded"
}

400Invalid request

{
  "error": {
    "message": "Invalid request",
    "type": "invalid_request_error",
    "code": "invalid_parameter"
  }
}

Get Template