Endpoint Index

A quick reference to the developer-facing endpoints. All paths are relative to the base URL:

https://api.blaick.ai/api/v1

Unless noted, every endpoint requires a Bearer token — a JWT or a blk_ API key.

Authentication

Method	Path	Auth	Description
POST	/auth/verify-api-key	Public	Check whether an API key is valid.

API keys

Method	Path	Description
POST	/users/me/api-keys	Create a key (full key returned once).
GET	/users/me/api-keys	List keys (metadata only).
DELETE	/users/me/api-keys/{id}	Revoke a key.

See Authentication.

Chat

Method	Path	Description
POST	/chat/completions	Generate a response (streaming or not).
POST	/chat/triage	Preview whether a cheaper model can handle a prompt.
POST	/chat/auto-route	Preview the auto-router's model choice.
WS	/chat/ws/{conversation_id}	Bidirectional streaming over WebSocket.
GET	/chat/conversations	List conversations.
POST	/chat/conversations	Create a conversation.
GET	/chat/conversations/{id}	Get a conversation with messages.
GET	/chat/conversations/{id}/messages	Paginate a conversation's messages.
DELETE	/chat/conversations/{id}	Delete a conversation.

See Chat Completions, Streaming, and Conversations.

Models

Method	Path	Description
GET	/models	List available models.
GET	/models/{id}	Get one model's details.

See Models.

Users & usage

Method	Path	Description
GET	/users/me	Current profile and token balance.
PUT	/users/me	Update your profile.
GET	/users/me/usage	Usage stats over a window of days.
GET	/users/me/activity	Per-request activity log.

See Usage & Tokens.

Billing & tokens

Method	Path	Description
GET	/billing/plans	List subscription plans.
POST	/billing/subscribe	Start a subscription (hosted checkout).
GET	/billing/subscription	Current subscription status.
POST	/billing/purchase	Buy a one-time token top-up.
GET	/billing/buckets	Token buckets and total remaining.
GET	/billing/history	Token transaction history.
POST	/billing/overage/enable	Enable on-demand overage.
POST	/billing/overage/disable	Disable overage.
GET	/billing/overage	Overage status.

See Usage & Tokens.

Agents & secrets

Method	Path	Description
GET	/agents	List agents.
POST	/agents	Create an agent.
GET	/agents/{id}	Get an agent.
PUT	/agents/{id}	Update an agent.
DELETE	/agents/{id}	Delete an agent.
POST	/agents/{id}/chat	Chat with an agent.
POST	/agents/{id}/runs	Run an agent now.
GET	/agents/{id}/runs	List runs.
GET	/agents/{id}/runs/{run_id}	Get a run with output.
GET	/secrets	List secrets (masked).
POST	/secrets	Create a secret.
PATCH	/secrets/{id}	Update a secret.
DELETE	/secrets/{id}	Delete a secret.

See Agents & Scheduling.

Referrals

Method	Path	Description
GET	/referrals/my-code	Get your personal referral code.
POST	/referrals/redeem	Redeem a referral code.
POST	/referrals/waitlist	Join the waitlist (public).

Health

Method	Path	Auth	Description
GET	/health	Public	Liveness probe.
GET	/health/ready	Public	Readiness check (dependencies).