Keys

Create an anonymous API key.

Mint a new anonymous-tier API key. Response includes the plaintext token exactly once — store it immediately; the server keeps only a hash. Present the token as Authorization: Bearer <token> on subsequent calls to POST /api/v1/scans to use the higher per-key rate limit (100 scans/day) instead of the per-IP anonymous limit (10 scans/day).

post/api/v1/keys

Request

  • Base URL: https://agentdisco.io
  • URL: https://agentdisco.io/api/v1/keys
  • Auth: none declared

Response

Key created.

idstring uuid required

UUID of the key row. Used as the rate-limit bucket identifier server-side.

tokenstring required

Plaintext token. Shown ONCE — store it now. Every subsequent request presents it as Authorization: Bearer <token>.

tokenPrefixstring required

First 10 chars of the token (ak_XXXXXXX). Safe to display + log.

labelstring nullable

Optional human name echoed back from the request, or null if none was given.

rateLimitTierstring required

Rate-limit tier this key uses. Today always anonymous (100 scans/day/key). Authenticated tiers land with user accounts.

createdAtstring date-time required

ISO 8601 creation timestamp.

Changes

No recorded changes to this operation across all 1 revision of this API.