Skip to main content
Revoke the previous secret

Get your Exa API key

Create a key in the dashboard. New accounts start with free credits.
The Team Management API is enabled per team. It authenticates with a service account API key, which is created from the Service keys tab on the API keys page once the feature is enabled for your team. Contact support@exa.ai to request access.

Overview

After a rotation with a grace period, the old secret keeps working until previousSecretExpiresAt. Call this endpoint once the new secret is deployed to revoke the old one immediately. The current secret is not affected. The request is safe to repeat: when there is no previous secret in its grace period, it returns revoked: false and changes nothing.

Authorizations

x-api-key
string
header
required

Service API key for team authentication

Path Parameters

id
string
required

The key's publicId. The key's current secret is also accepted for backward compatibility.

Response

Previous secret revoked, or there was none to revoke

apiKey
object
revoked
boolean

Whether a previous secret was revoked by this request.