Skip to content

docs(agent-id): migrate API references to agent-api.self.xyz; retire consumer UI#23

Draft
kartikmehta8 wants to merge 1 commit into
mainfrom
docs/agent-id-api-migration
Draft

docs(agent-id): migrate API references to agent-api.self.xyz; retire consumer UI#23
kartikmehta8 wants to merge 1 commit into
mainfrom
docs/agent-id-api-migration

Conversation

@kartikmehta8

Copy link
Copy Markdown
Member

What

Updates the Self Agent ID docs for the API migration: the hosted consumer
web app is being retired and the API moves to a dedicated host
(agent-api.self.xyz). All features are retained — nothing is dropped.

Changes

  • New page — Register Without the Web App: SDK-first registration loop
    (render the QR client-side with @selfxyz/qrcode, mint on-chain, sign,
    verify). Needs no hosted service. Added to the Agent ID nav.
  • Rehosted all API references to https://agent-api.self.xyz (was
    selfagentid.xyz): REST API, A2A endpoint, CLI, Celo Agent Visa, AA proxy.
  • overview.md: "Where It Lives" now lists the API host; consumer-website
    framing updated.
  • rest-api.md: base URL set to the new host; removed the dead
    api-docs link; apiBase example updated.
  • cli.md: notes the CLI uses agent-api.self.xyz (override via
    SELF_AGENT_API_BASE) and fetches the QR from /api/qr/{sessionToken}.
  • agent-builder.md: replaced the retired dApp wizard with the SDK path;
    updated A2A/REST examples and the smart-wallet section.
  • mcp-user.md: SELF_AGENT_API_BASE default updated.

Not changing

On-chain registration (Hub V2 mint) and verification are unaffected — they
never depended on the hosted app. No features removed.

…consumer UI

The Agent ID hosted web app is being retired and the API moved to a
dedicated host. Update the docs to match while keeping every feature:

- Point REST, A2A, CLI, visa, and AA proxy references at
  https://agent-api.self.xyz (was selfagentid.xyz).
- Replace the retired dApp wizard with an SDK-first registration page
  (Register Without the Web App): render the QR client-side, mint
  on-chain, sign, and verify, with no hosted service required.
- Note CLI/REST as alternatives that return the QR for you to display,
  and that the CLI fetches the QR from /api/qr.
- mcp-user: SELF_AGENT_API_BASE default updated.

No features dropped; on-chain registration and verification unchanged.

Co-Authored-By: Claude Opus 4.8 <[email protected]>
@kartikmehta8 kartikmehta8 self-assigned this Jun 10, 2026
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