Skip to content

docs(enterprise): the account endpoints were live and undocumented - #99

Merged
VickyXAI merged 1 commit into
mainfrom
docs/enterprise-api-page
Sep 13, 2026
Merged

VickyXAI merged 1 commit into
mainfrom
docs/enterprise-api-page

Conversation

@VickyXAI

Copy link
Copy Markdown
Contributor

A customer asked whether there is an API to read their balance, and said they could not find docs for it. There is no page — but the endpoints have been live on api.blockrun.ai the whole time:

Endpoint Answers
GET /v1/credits How much is left, and whether the next call will be refused
GET /v1/account The same payload
GET /v1/usage/summary Totals over a window, by day, model, endpoint and key
GET /v1/usage The row-level ledger, newest first, paginated

blockrun.ai/docs opens with "no API keys", because it documents the x402 product. An enterprise customer holding a brk_live_ key reads that and concludes we have nothing for them. That is what happened.

What's here

  • docs/getting-started/enterprise-api.md — the page merged in the enterprise repo (8e8276cc, BlockRunAI/enterprise#193), where every response shape was verified against the handlers and against production. Moved here so it renders at blockrun.ai/docs, which is where customers look.
  • Its one relative link is repointed for the new depth: products/intelligence/pricing.md../products/intelligence/pricing.md (the kind row of the /v1/usage field table), matching how sdk-developers.md and agent-developers.md already link to that page.
  • docs/SUMMARY.md — listed under Getting Started, after Wallet Setup. Wallet Setup is the x402 on-ramp; this is the other one.
  • docs/README.md — the Links line said enterprise sign-in was "coming soon". It is live, so it now points at this page and at user.blockrun.ai.

Notes

No new claims and no counts — nothing for the brand-number guards to check. :::tip and :::info are both in callout.tsx's Kind union, so the directives render.

Shipping this needs the awesome-blockrun pointer bumped in blockrun and a deploy; that PR follows.

🤖 Generated with Claude Code

https://claude.ai/code/session_01R81gntfKNoGiN2MSCPy7xY

A customer asked whether there is an API to read their balance and could
not find it. There isn't a page — the endpoints have been live on
api.blockrun.ai the whole time:

  GET /v1/credits         balance, and whether the next call is refused
  GET /v1/account         the same payload
  GET /v1/usage/summary   totals by day, model, endpoint and key
  GET /v1/usage           the row-level ledger, paginated

blockrun.ai/docs opens with "no API keys", because it is the x402
product. An enterprise customer holding a brk_live_ key reads that and
concludes we have no docs for them, which is what happened.

The page is the one merged in the enterprise repo (8e8276cc, #193) —
every response shape verified against the handlers and against prod —
moved here so it renders at blockrun.ai/docs where customers look. Its
one relative link is repointed for the new depth
(products/intelligence/pricing.md -> ../products/intelligence/pricing.md).

README's Links line said enterprise sign-in was "coming soon". It is
live, so it now points at the new page and at user.blockrun.ai.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01R81gntfKNoGiN2MSCPy7xY
@VickyXAI
VickyXAI merged commit 06f6f06 into main Sep 13, 2026
1 check passed
@VickyXAI
VickyXAI deleted the docs/enterprise-api-page branch September 13, 2026 17:28
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant