Skip to main content
GET
/
v1
/
api-keys
/
{id}
Get API Key
curl --request GET \
  --url https://api.example.com/v1/api-keys/{id}
{
  "id": "<string>",
  "organization_id": "<string>",
  "decrypted_key": "<string>",
  "created_at": "<string>",
  "modified_at": "<string>",
  "expiration_date": "<string>",
  "last_used_date": "<string>",
  "created_by_email": "<string>",
  "modified_by_email": "<string>"
}

Overview

Retrieve detailed information about a specific API key, including its decrypted value and usage metadata.

Path Parameters

id
string
required
Unique UUID identifier of the API keyExample: “550e8400-e29b-41d4-a716-446655440000”

Response

id
string
required
Unique UUID identifier of the API key
organization_id
string
required
UUID of the organization this key belongs to
decrypted_key
string
required
The actual API key value (encrypted in storage, decrypted in response)
created_at
string
required
When the key was created (ISO 8601)
modified_at
string
required
When the key was last modified (ISO 8601)
expiration_date
string
required
When the key will expire (ISO 8601)
last_used_date
string
When the key was last used for API requests (ISO 8601). null if never used.
created_by_email
string
Email address of the user who created the key
modified_by_email
string
Email address of the user who last modified the key

Example Request

curl "https://api.airweave.ai/v1/api-keys/550e8400-e29b-41d4-a716-446655440000" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example Response

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "organization_id": "770e8400-e29b-41d4-a716-446655440001",
  "decrypted_key": "awv_live_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6",
  "created_at": "2024-03-15T10:00:00Z",
  "modified_at": "2024-03-15T10:00:00Z",
  "expiration_date": "2024-06-13T10:00:00Z",
  "last_used_date": "2024-03-20T14:30:00Z",
  "created_by_email": "[email protected]",
  "modified_by_email": "[email protected]"
}

Error Responses

404 Not Found
API key with the specified ID does not exist or does not belong to your organization
401 Unauthorized
Missing or invalid authentication

Build docs developers (and LLMs) love