---
title: "Validate an Outlit API key"
method: POST
path: "/api/validate-api-key"
---

# Validate an Outlit API key

`POST /api/validate-api-key`

## Response `200`

Validated API-key context

- ApiKeyValidationSuccess
  - `valid` true, required
  - `organizationId` string, required
  - `createdById` string, nullable, required
  - `organization` object
    - `id` string, required
    - `name` string, nullable, required
    - `slug` string, nullable, required
  - `createdBy` object, nullable
    - `id` string, required
    - `email` string, required
    - `name` string, nullable, required
  - `apiKey` object
    - `id` string, required
    - `name` string, required
    - `prefix` string, required
    - `keyType` 'api' | 'cli' | 'mcp' | 'ci', required
    - `grants` string[], required
    - `createdAt` string, date-time, required
    - `lastUsedAt` string, date-time, nullable, required
    - `totalRequests` integer, required
  - `authorization` object, required
    - `grants` string[], required

## Other responses

- `401` — Invalid credentials
- `503` — API-key validation unavailable

## Changes

- **2026-08-11** `daa1820664db` — 2 warning
  - added the new `integrations:connect_own` enum value to the `apiKey/grants/items/` response property for the response status `200`
  - added the new `integrations:connect_own` enum value to the `authorization/grants/items/` response property for the response status `200`
- **2026-08-09** `2ec7a43a31d5` — 2 warning
  - added the new `behavior_metrics:manage` enum value to the `apiKey/grants/items/` response property for the response status `200`
  - added the new `behavior_metrics:manage` enum value to the `authorization/grants/items/` response property for the response status `200`
- **2026-08-06** `5657e401e81d` — 2 warning
  - added the new `customer_access:manage` enum value to the `apiKey/grants/items/` response property for the response status `200`
  - added the new `customer_access:manage` enum value to the `authorization/grants/items/` response property for the response status `200`
- **2026-08-05** `7fac501c2674` — 1 breaking, 1 warning, 10 info
  - response property `createdById` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - removed the optional property `details` from the response with the `401` status
  - api tag `Platform API` removed
  - added the non-success response with the status `503`
  - …8 more

[Change history](https://skmtc.dev/outlitai/apis/outlit-api/changes/api/validate-api-key/post.md)

---

[API](https://skmtc.dev/outlitai/apis/outlit-api.md) · [All operations](https://skmtc.dev/outlitai/apis/outlit-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/outlitai/outlit-api/revisions/691ecaf8539a/schema)