POST /v1/api_keys - SEC API for AI

curl -X POST \
  -H "Authorization: Bearer $SECAPI_BEARER_TOKEN" \
  -H "secapi-version: 2026-03-19" \
  -H "content-type: application/json" \
  -d '{"label":"local-dev"}' \
  "https://api.secapi.ai/v1/api_keys"

{
  "object": "api_key",
  "id": "key_123",
  "createdAt": "2026-06-27T21:00:00.000Z",
  "livemode": false,
  "orgId": "org_123",
  "label": "local-dev",
  "keyPrefix": "secapi_live_abcd",
  "scopes": [
    "read:sec"
  ],
  "status": "active",
  "lastUsedAt": null,
  "secret": "secapi_live_abcd...copy_this_once"
}

Create a new API key for the current organization and reveal its secret exactly once

Audience: application and coding agent.

Canonical metadata

requestId
traceparent

Example request

curl -X POST \
  -H "Authorization: Bearer $SECAPI_BEARER_TOKEN" \
  -H "secapi-version: 2026-03-19" \
  -H "content-type: application/json" \
  -d '{"label":"local-dev"}' \
  "https://api.secapi.ai/v1/api_keys"

POST /v1/api_keys is a dashboard/control-plane operation. Use a WorkOS browser-session bearer token with api_keys:manage permission to create the key. After creation, use the returned secret as the x-api-key header for REST, SDK, CLI, and server-to-server MCP requests. The secret is revealed exactly once; later list responses return metadata and prefix only.

Example response

{
  "object": "api_key",
  "id": "key_123",
  "createdAt": "2026-06-27T21:00:00.000Z",
  "livemode": false,
  "orgId": "org_123",
  "label": "local-dev",
  "keyPrefix": "secapi_live_abcd",
  "scopes": [
    "read:sec"
  ],
  "status": "active",
  "lastUsedAt": null,
  "secret": "secapi_live_abcd...copy_this_once"
}

Give this prompt to your agent

Failure posture

treat non-2xx responses as contract-aware failures, not free-form errors
preserve requestId and traceparent in logs and downstream reports
if provenance or freshness metadata is present, return it unchanged so trust is not lost in the handoff

GET /v1/api_keys GET /v1/billing

​Canonical metadata

​Example request

​Example response

​Give this prompt to your agent

​Failure posture

Canonical metadata

Example request

Example response

Give this prompt to your agent

Failure posture