{"openapi":"3.0.3","info":{"title":"Agentify.Help — WellAgent Registry & Consultation API","version":"1.1.0","description":"One-per-person WellAgent registry and expert consultation surface. Covers steward registration (agentify.help), corpus assembly skill, and the WellAgent consultation endpoints (wellspr.ing). First registration wins — no duplicates.","contact":{"email":"ody@wellspr.ing","url":"https://agentify.help"}},"servers":[{"url":"https://agentify.help","description":"Registry, skill files, and steward tools"},{"url":"https://wellspr.ing","description":"Corpus intake, expert index, and consultation"}],"tags":[{"name":"registry","description":"Steward registration and public ledger — agentify.help"},{"name":"corpus","description":"Corpus assembly skill and intake — agentify.help + wellspr.ing"},{"name":"consultation","description":"Live WellAgent expert consultation — wellspr.ing"}],"paths":{"/api/agentify-help/check":{"post":{"tags":["registry"],"operationId":"check_availability","summary":"Check if an expert name is available","servers":[{"url":"https://agentify.help"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["name"],"properties":{"name":{"type":"string"}}}}}},"responses":{"200":{"description":"Availability result","content":{"application/json":{"schema":{"type":"object","properties":{"available":{"type":"boolean"},"slug":{"type":"string"},"existing":{"type":"object"}}}}}}}}},"/api/agentify-help/register":{"post":{"tags":["registry"],"operationId":"register","summary":"Register as first steward for an expert persona","servers":[{"url":"https://agentify.help"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["name","steward_name","steward_email"],"properties":{"name":{"type":"string"},"subject_domain":{"type":"string"},"steward_name":{"type":"string"},"steward_email":{"type":"string"},"host_url":{"type":"string"},"registered_via":{"type":"string","description":"Set to your agent/Replit identifier to waive the human checkbox"}}}}}},"responses":{"200":{"description":"Registration confirmed","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"slug":{"type":"string"},"registration_number":{"type":"integer"}}}}}},"409":{"description":"Already registered"}}}},"/api/registry.json":{"get":{"tags":["registry"],"operationId":"list_registry","summary":"Full public registry as JSON","servers":[{"url":"https://agentify.help"}],"parameters":[{"name":"limit","in":"query","schema":{"type":"integer","default":50,"maximum":100}},{"name":"status","in":"query","schema":{"type":"string","enum":["active","pending","claimed"]}}],"responses":{"200":{"description":"Registry list","content":{"application/json":{"schema":{"type":"object","properties":{"registry":{"type":"array"},"count":{"type":"integer"},"updated":{"type":"string"}}}}}}}}},"/api/feed.json":{"get":{"tags":["registry"],"operationId":"get_feed","summary":"Recent registrations feed — chronological, newest first","servers":[{"url":"https://agentify.help"}],"parameters":[{"name":"limit","in":"query","schema":{"type":"integer","default":20,"maximum":100}}],"responses":{"200":{"description":"Feed of recent registrations"}}}},"/agentify-corpus/skill.md":{"get":{"tags":["corpus"],"operationId":"get_corpus_skill","summary":"Corpus assembly skill file — hand to any AI coding agent","description":"Full protocol for assembling and submitting a WellAgent corpus: chunk format, manifest schema, intake API flow, quality gates, and versioning rules. Serve this URL to Cursor, Claude Projects, or any AI agent to give it complete build context.","servers":[{"url":"https://agentify.help"}],"responses":{"200":{"description":"Markdown skill file","content":{"text/markdown":{"schema":{"type":"string"}}}}}}},"/api/agentify/experts":{"get":{"tags":["consultation"],"operationId":"list_experts","summary":"List all active WellAgents with metadata","description":"Returns slug, name, credentials, primary_domain, scopes, refusals, and status for every non-deprecated expert. No auth required.","servers":[{"url":"https://wellspr.ing"}],"responses":{"200":{"description":"Expert index","content":{"application/json":{"schema":{"type":"object","properties":{"experts":{"type":"array","items":{"type":"object","properties":{"slug":{"type":"string"},"expert_name":{"type":"string"},"credentials":{"type":"string"},"primary_domain":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}},"refusals":{"type":"array","items":{"type":"string"}},"status":{"type":"string"}}}}}}}}}}}},"/api/agentify/experts/{slug}/status":{"get":{"tags":["consultation"],"operationId":"get_expert_status","summary":"Check corpus readiness for a WellAgent","servers":[{"url":"https://wellspr.ing"}],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Readiness and bundle info","content":{"application/json":{"schema":{"type":"object","properties":{"isReady":{"type":"boolean"},"embeddedChunks":{"type":"integer"},"latestBundle":{"type":"object","properties":{"status":{"type":"string"},"chunk_count":{"type":"integer"},"distillation_notes":{"type":"string"}}},"consultEndpoint":{"type":"string","nullable":true}}}}}},"404":{"description":"Expert not found"}}}},"/api/agentify/experts/{slug}/consult":{"post":{"tags":["consultation"],"operationId":"consult_expert","summary":"Ask a question to a WellAgent expert","description":"Submits a question to the expert's corpus-grounded AI. Returns a sourced answer, the supporting chunks used for retrieval, and the retrieval method. Requires X-Admin-Key (internal) or X-Partner-Token (issued tokens).","servers":[{"url":"https://wellspr.ing"}],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"AdminKey":[]},{"PartnerToken":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["question"],"properties":{"question":{"type":"string","description":"Plain-language question for the expert"},"context":{"type":"object","description":"Optional context (e.g. ehr: patient EHR text)"}}}}}},"responses":{"200":{"description":"Expert answer with source chunks","content":{"application/json":{"schema":{"type":"object","properties":{"answer":{"type":"string"},"chunks":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"title":{"type":"string"},"similarity":{"type":"number"}}}},"retrieval":{"type":"string","enum":["dense","fts"]},"expert_name":{"type":"string"},"slug":{"type":"string"},"bundle_id":{"type":"string"}}}}}},"401":{"description":"X-Partner-Token required"},"403":{"description":"Invalid token"},"503":{"description":"Expert corpus not ready — run distillation first"}}}}},"components":{"securitySchemes":{"AdminKey":{"type":"apiKey","in":"header","name":"X-Admin-Key"},"PartnerToken":{"type":"apiKey","in":"header","name":"X-Partner-Token"}}}}