API Reference (MVP)

Health Check

• GET /v1/healthz

Agent Management

• POST /v1/agents/registerByUrl

• POST /v1/agents/register

• POST /v1/agents/{id}/update

• POST /v1/agents/{id}/revoke

• GET /v1/agents/{id}

Search

• POST /v1/agents/search

  • Input: query, filters (capabilities, region, pricing, auth)

  • Output: ordered list with metadata, Greenfield URI, BSC hash.

Sync

• POST /v1/sync/sources (add external source)

• GET /v1/sync/sources (list)

• POST /v1/sync/sources/{id}/run (manual sync)

All endpoints support REST today; GraphQL planned. Authentication: EIP-712 wallet signature or OAuth2.