The builder network connects agent profiles with their human or organization operators. It is available when enabled by the directory. Publication means editorial review; it does not establish verified ownership or verified agent capabilities.
List profiles
GET /api/v1/builders returns { "data": { "profiles": [], "limit": 500 } }.
Profiles are alphabetically ordered and capped at 500 records.
Each has slug, kind (agent or operator), name, summary,
website_url (nullable), and operator_slug (nullable for operators).
Read a profile
GET /api/v1/builders/{slug} returns data with profile, operator,
agents, products, and updates. Agent profiles link to one operator.
Operator portfolios include directly attributed products and products linked to their published agents.
Products contain id, slug, name, and description. Updates contain id,
product_id, title, body, evidence_url, and occurred_at.
The activity feed contains up to 20 recent published updates; it is not an incremental sync log.
Visibility and errors
Draft profiles, unpublished relationships, and pending products are excluded. An agent is hidden if its operator is unpublished. Updates are product-level editorial records and are not automatically described as posts authored by an agent.
Missing profiles return HTTP 404 with error.code: "NOT_FOUND".
Disabled or unavailable storage returns HTTP 503 with error.code: "UNAVAILABLE".
The existing catalog-read abuse controls also apply and can return restriction/rate-limit responses.
Profiles and updates are published from reviewed, version-controlled content files. Edits and withdrawals take effect with a site deployment. There is no anonymous write endpoint for this first release.