{"openapi":"3.0.3","info":{"title":"NANDA Index Server","description":"GARR v2 — NANDA Index Server. Stores IndexRecords pointing to Registry Servers. Registry Servers store AgentRecords with card_url links to A2A cards.","version":"2.0.0"},"components":{"schemas":{}},"paths":{"/health":{"get":{"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["status","db"],"additionalProperties":false,"properties":{"status":{"type":"string","enum":["ok"]},"db":{"type":"string","enum":["ok"]}}}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"endpoint":{"type":"string"}}}}}}}}},"/auth/providers":{"get":{"summary":"List configured OAuth providers","tags":["auth"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"google":{"type":"boolean"},"github":{"type":"boolean"}}}}}}}}},"/auth/google/callback":{"get":{"responses":{"200":{"description":"Default Response"}}}},"/auth/register":{"post":{"tags":["auth"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["email","password"],"additionalProperties":false,"properties":{"email":{"type":"string","format":"email","maxLength":255},"password":{"type":"string","minLength":8},"display_name":{"type":"string","maxLength":255}}}}}},"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["token"],"properties":{"token":{"type":"string"}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"endpoint":{"type":"string"}}}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"endpoint":{"type":"string"}}}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"endpoint":{"type":"string"}}}}}}}}},"/auth/login":{"post":{"tags":["auth"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["email","password"],"additionalProperties":false,"properties":{"email":{"type":"string","format":"email","maxLength":255},"password":{"type":"string","minLength":8,"maxLength":128}}}}}},"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["token"],"properties":{"token":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"endpoint":{"type":"string"}}}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"endpoint":{"type":"string"}}}}}}}}},"/auth/forgot-password":{"post":{"summary":"Request a password reset email","tags":["auth"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["email"],"additionalProperties":false,"properties":{"email":{"type":"string","format":"email","maxLength":255}}}}}},"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["ok"],"properties":{"ok":{"type":"boolean"}}}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"endpoint":{"type":"string"}}}}}}}}},"/auth/reset-password":{"post":{"summary":"Set a new password using a reset token","tags":["auth"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["token","password"],"additionalProperties":false,"properties":{"token":{"type":"string","minLength":1,"maxLength":256},"password":{"type":"string","minLength":8}}}}}},"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["ok"],"properties":{"ok":{"type":"boolean"}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"endpoint":{"type":"string"}}}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"endpoint":{"type":"string"}}}}}}}}},"/auth/github/callback":{"get":{"responses":{"200":{"description":"Default Response"}}}},"/auth/verify-account":{"post":{"summary":"Verify the account email using the emailed token","tags":["auth"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["token"],"additionalProperties":false,"properties":{"token":{"type":"string","minLength":1,"maxLength":256}}}}}},"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["ok"],"properties":{"ok":{"type":"boolean"}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"endpoint":{"type":"string"}}}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"endpoint":{"type":"string"}}}}}}}}},"/auth/resend-account-verification":{"post":{"summary":"Send a new account verification email","tags":["auth"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["ok"],"properties":{"ok":{"type":"boolean"},"already_verified":{"type":"boolean"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"endpoint":{"type":"string"}}}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"endpoint":{"type":"string"}}}}}}}}},"/api/v1/me":{"patch":{"summary":"Update your display name","tags":["auth"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["display_name"],"additionalProperties":false,"properties":{"display_name":{"type":["string","null"],"maxLength":255}}}}}},"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["token","display_name"],"properties":{"token":{"type":"string"},"display_name":{"type":["null","string"]}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"endpoint":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"endpoint":{"type":"string"}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"endpoint":{"type":"string"}}}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"endpoint":{"type":"string"}}}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"endpoint":{"type":"string"}}}}}}}},"delete":{"summary":"Delete your account after confirming account control","tags":["auth"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["confirmation"],"additionalProperties":false,"properties":{"confirmation":{"enum":["DELETE"]},"current_password":{"type":"string","minLength":1,"maxLength":128},"deletion_code":{"type":"string","maxLength":128}}}}}},"responses":{"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"endpoint":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"endpoint":{"type":"string"}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"endpoint":{"type":"string"}}}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error","detail"],"properties":{"error":{"type":"string"},"detail":{"type":"string"},"organizations":{"type":"array","items":{"type":"object","required":["org_id","display_name"],"properties":{"org_id":{"type":"string"},"display_name":{"type":"string"}}}}}}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"endpoint":{"type":"string"}}}}}}}},"get":{"summary":"Get the authenticated user profile","tags":["auth"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["user_id","email","email_verified","orgs"],"properties":{"user_id":{"type":"string"},"email":{"type":"string"},"email_verified":{"type":"boolean"},"display_name":{"type":["null","string"]},"avatar_url":{"type":["null","string"]},"has_password":{"type":"boolean"},"auth_provider":{"type":"string","enum":["email","google","github"]},"deletion_blockers":{"type":"array","items":{"type":"object","required":["org_id","display_name"],"properties":{"org_id":{"type":"string"},"display_name":{"type":"string"}}}},"orgs":{"type":"array","items":{"type":"object","required":["org_id","display_name","role","status","domain","email_verified","domain_verified"],"properties":{"org_id":{"type":"string"},"display_name":{"type":"string"},"role":{"type":"string"},"status":{"type":"string","enum":["pending","active","suspended"]},"domain":{"type":["null","string"]},"email_verified":{"type":"boolean"},"domain_verified":{"type":"boolean"}}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"endpoint":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"endpoint":{"type":"string"}}}}}}}}},"/auth/change-password":{"post":{"summary":"Change password and revoke every session","tags":["auth"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["current_password","new_password"],"additionalProperties":false,"properties":{"current_password":{"type":"string","minLength":1,"maxLength":128},"new_password":{"type":"string","minLength":8}}}}}},"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["ok"],"properties":{"ok":{"type":"boolean"}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"endpoint":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"endpoint":{"type":"string"}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"endpoint":{"type":"string"}}}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"endpoint":{"type":"string"}}}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"endpoint":{"type":"string"}}}}}}}}},"/auth/logout-all":{"post":{"summary":"Sign out every session including this one","tags":["auth"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["ok"],"properties":{"ok":{"type":"boolean"}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"endpoint":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"endpoint":{"type":"string"}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"endpoint":{"type":"string"}}}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"endpoint":{"type":"string"}}}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"endpoint":{"type":"string"}}}}}}}}},"/auth/request-account-deletion":{"post":{"summary":"Email a deletion confirmation code for an OAuth account","tags":["auth"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["ok"],"properties":{"ok":{"type":"boolean"}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"endpoint":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"endpoint":{"type":"string"}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"endpoint":{"type":"string"}}}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"endpoint":{"type":"string"}}}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"endpoint":{"type":"string"}}}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"endpoint":{"type":"string"}}}}}}}}},"/api/v1/index":{"get":{"summary":"List index entries (AI Catalog entry shape), paged; total in X-Total-Count","tags":["index"],"parameters":[{"schema":{"type":"integer","minimum":1,"maximum":500,"default":100},"in":"query","name":"limit","required":false},{"schema":{"type":"integer","minimum":0,"default":0},"in":"query","name":"offset","required":false}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","required":["identifier","displayName","type","tags","updatedAt","extensions"],"additionalProperties":false,"properties":{"identifier":{"type":"string"},"displayName":{"type":"string"},"type":{"type":"string"},"url":{"type":"string"},"data":{"type":"object","additionalProperties":true},"description":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"version":{"type":"string"},"publisher":{"type":"object","properties":{"identifier":{"type":"string"},"displayName":{"type":"string"},"identityType":{"type":"string"}}},"trustManifest":{"type":"object","additionalProperties":true,"properties":{"identity":{"type":"string"},"identityType":{"type":"string"},"trustSchema":{"type":"object","additionalProperties":true},"attestations":{"type":"array","items":{"type":"object","additionalProperties":true}},"provenance":{"type":"array","items":{"type":"object","additionalProperties":true}},"privacyPolicyUrl":{"type":"string"},"termsOfServiceUrl":{"type":"string"},"signature":{"type":"string"},"metadata":{"type":"object","additionalProperties":true}}},"trustManifestVerified":{"type":"boolean"},"updatedAt":{"type":"string"},"extensions":{"type":"object","additionalProperties":{"type":"object","additionalProperties":true}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"endpoint":{"type":"string"}}}}}}}}},"/api/v1/index/{org_id}":{"get":{"summary":"Get a single live index entry (AI Catalog entry shape)","tags":["index"],"description":"Only live entries (active, proven, not taken down) are public: pending, suspended, unproven and taken-down entries return 404, the same as an unknown org_id.","parameters":[{"schema":{"type":"string"},"in":"path","name":"org_id","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["identifier","displayName","type","tags","updatedAt","extensions"],"additionalProperties":false,"properties":{"identifier":{"type":"string"},"displayName":{"type":"string"},"type":{"type":"string"},"url":{"type":"string"},"data":{"type":"object","additionalProperties":true},"description":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"version":{"type":"string"},"publisher":{"type":"object","properties":{"identifier":{"type":"string"},"displayName":{"type":"string"},"identityType":{"type":"string"}}},"trustManifest":{"type":"object","additionalProperties":true,"properties":{"identity":{"type":"string"},"identityType":{"type":"string"},"trustSchema":{"type":"object","additionalProperties":true},"attestations":{"type":"array","items":{"type":"object","additionalProperties":true}},"provenance":{"type":"array","items":{"type":"object","additionalProperties":true}},"privacyPolicyUrl":{"type":"string"},"termsOfServiceUrl":{"type":"string"},"signature":{"type":"string"},"metadata":{"type":"object","additionalProperties":true}}},"trustManifestVerified":{"type":"boolean"},"updatedAt":{"type":"string"},"extensions":{"type":"object","additionalProperties":{"type":"object","additionalProperties":true}}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"endpoint":{"type":"string"}}}}}}}}},"/api/v1/verify-email":{"get":{"summary":"Forward an emailed verification link to the web confirmation page","tags":["auth"],"parameters":[{"schema":{"type":"string"},"in":"query","name":"token","required":false}],"responses":{"200":{"description":"Default Response"}}},"post":{"summary":"Verify org contact email (activates personal orgs; others still need domain verification)","tags":["auth"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["token"],"properties":{"token":{"type":"string","minLength":1,"maxLength":128}}}}}},"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["org_id","display_name","identifier","extensions","ttl_seconds","status","email_verified","domain_verified","created_at","updated_at"],"properties":{"org_id":{"type":"string"},"display_name":{"type":"string"},"domain":{"type":["null","string"]},"registry_url":{"type":["null","string"]},"ttl_seconds":{"type":"number"},"status":{"type":"string","enum":["pending","active","suspended"]},"email_verified":{"type":"boolean"},"email_verified_at":{"type":["null","string"]},"domain_verified_at":{"type":["null","string"]},"card_validation":{"type":["null","object"],"additionalProperties":true},"domain_verified":{"type":"boolean"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"identifier":{"type":"string"},"media_type":{"type":"string"},"description":{"type":["null","string"]},"tags":{"type":"array","items":{"type":"string"}},"publisher":{"type":"object","properties":{"identifier":{"type":"string"},"displayName":{"type":"string"},"identityType":{"type":"string"}}},"extensions":{"type":"object","additionalProperties":{"type":"object","additionalProperties":true}},"data":{"type":"object","additionalProperties":true},"version":{"type":"string"},"trust_manifest":{"type":"object","additionalProperties":true,"properties":{"identity":{"type":"string"},"identityType":{"type":"string"},"trustSchema":{"type":"object","additionalProperties":true},"attestations":{"type":"array","items":{"type":"object","additionalProperties":true}},"provenance":{"type":"array","items":{"type":"object","additionalProperties":true}},"privacyPolicyUrl":{"type":"string"},"termsOfServiceUrl":{"type":"string"},"signature":{"type":"string"},"metadata":{"type":"object","additionalProperties":true}}},"trust_manifest_verified":{"type":"boolean"},"moderation":{"type":"string","enum":["none","hidden","takedown"]},"representative_queries":{"type":"array","items":{"type":"string"}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"endpoint":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"endpoint":{"type":"string"}}}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"endpoint":{"type":"string"}}}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"endpoint":{"type":"string"}}}}}}}}},"/api/v1/orgs":{"post":{"summary":"Register a new organization (creates index record)","tags":["orgs"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["org_id","display_name","contact_email","registry_url"],"properties":{"org_id":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*[a-z0-9]$","minLength":2,"maxLength":64},"display_name":{"type":"string","minLength":1,"maxLength":255},"hosting_path":{"type":"string","enum":["registry","dns-svcb","smb","personal"]},"domain":{"type":"string","maxLength":255},"contact_email":{"type":"string","format":"email"},"registry_url":{"type":"string","maxLength":512},"ttl_seconds":{"type":"integer","minimum":3600,"maximum":604800},"identifier":{"type":"string","maxLength":512},"media_type":{"type":"string","maxLength":128,"enum":["application/ai-catalog+json","application/ai-registry+json","application/vnd.ans-registry+json","application/a2a-agent-card+json","application/mcp-server-card+json","application/agentskill+zip"]},"description":{"type":"string","maxLength":1000},"tags":{"type":"array","items":{"type":"string","maxLength":64},"maxItems":20},"version":{"type":"string","maxLength":64},"publisher":{"type":"object","required":["displayName"],"properties":{"displayName":{"type":"string","minLength":1,"maxLength":255}}},"extensions":{"type":"object","additionalProperties":{"type":"object","additionalProperties":true}},"entry_data":{"type":"object","additionalProperties":true},"trust_manifest":{"type":"object","additionalProperties":true,"properties":{"identity":{"type":"string"},"identityType":{"type":"string"},"trustSchema":{"type":"object","additionalProperties":true},"attestations":{"type":"array","items":{"type":"object","additionalProperties":true}},"provenance":{"type":"array","items":{"type":"object","additionalProperties":true}},"privacyPolicyUrl":{"type":"string"},"termsOfServiceUrl":{"type":"string"},"signature":{"type":"string"},"metadata":{"type":"object","additionalProperties":true}}}}}}}},"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["org_id","display_name","identifier","extensions","ttl_seconds","status","email_verified","domain_verified","created_at","updated_at"],"properties":{"org_id":{"type":"string"},"display_name":{"type":"string"},"domain":{"type":["null","string"]},"registry_url":{"type":["null","string"]},"ttl_seconds":{"type":"number"},"status":{"type":"string","enum":["pending","active","suspended"]},"email_verified":{"type":"boolean"},"email_verified_at":{"type":["null","string"]},"domain_verified_at":{"type":["null","string"]},"card_validation":{"type":["null","object"],"additionalProperties":true},"domain_verified":{"type":"boolean"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"identifier":{"type":"string"},"media_type":{"type":"string"},"description":{"type":["null","string"]},"tags":{"type":"array","items":{"type":"string"}},"publisher":{"type":"object","properties":{"identifier":{"type":"string"},"displayName":{"type":"string"},"identityType":{"type":"string"}}},"extensions":{"type":"object","additionalProperties":{"type":"object","additionalProperties":true}},"data":{"type":"object","additionalProperties":true},"version":{"type":"string"},"trust_manifest":{"type":"object","additionalProperties":true,"properties":{"identity":{"type":"string"},"identityType":{"type":"string"},"trustSchema":{"type":"object","additionalProperties":true},"attestations":{"type":"array","items":{"type":"object","additionalProperties":true}},"provenance":{"type":"array","items":{"type":"object","additionalProperties":true}},"privacyPolicyUrl":{"type":"string"},"termsOfServiceUrl":{"type":"string"},"signature":{"type":"string"},"metadata":{"type":"object","additionalProperties":true}}},"trust_manifest_verified":{"type":"boolean"},"moderation":{"type":"string","enum":["none","hidden","takedown"]},"representative_queries":{"type":"array","items":{"type":"string"}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"endpoint":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"endpoint":{"type":"string"}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"endpoint":{"type":"string"}}}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"endpoint":{"type":"string"}}}}}}}}},"/api/v1/orgs/{org_id}":{"get":{"summary":"Get your organization","tags":["orgs"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"org_id","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["org_id","display_name","identifier","extensions","ttl_seconds","status","email_verified","domain_verified","created_at","updated_at"],"properties":{"org_id":{"type":"string"},"display_name":{"type":"string"},"domain":{"type":["null","string"]},"registry_url":{"type":["null","string"]},"ttl_seconds":{"type":"number"},"status":{"type":"string","enum":["pending","active","suspended"]},"email_verified":{"type":"boolean"},"email_verified_at":{"type":["null","string"]},"domain_verified_at":{"type":["null","string"]},"card_validation":{"type":["null","object"],"additionalProperties":true},"domain_verified":{"type":"boolean"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"identifier":{"type":"string"},"media_type":{"type":"string"},"description":{"type":["null","string"]},"tags":{"type":"array","items":{"type":"string"}},"publisher":{"type":"object","properties":{"identifier":{"type":"string"},"displayName":{"type":"string"},"identityType":{"type":"string"}}},"extensions":{"type":"object","additionalProperties":{"type":"object","additionalProperties":true}},"data":{"type":"object","additionalProperties":true},"version":{"type":"string"},"trust_manifest":{"type":"object","additionalProperties":true,"properties":{"identity":{"type":"string"},"identityType":{"type":"string"},"trustSchema":{"type":"object","additionalProperties":true},"attestations":{"type":"array","items":{"type":"object","additionalProperties":true}},"provenance":{"type":"array","items":{"type":"object","additionalProperties":true}},"privacyPolicyUrl":{"type":"string"},"termsOfServiceUrl":{"type":"string"},"signature":{"type":"string"},"metadata":{"type":"object","additionalProperties":true}}},"trust_manifest_verified":{"type":"boolean"},"moderation":{"type":"string","enum":["none","hidden","takedown"]},"representative_queries":{"type":"array","items":{"type":"string"}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"endpoint":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"endpoint":{"type":"string"}}}}}}}},"put":{"summary":"Update your organization's index record","tags":["orgs"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"display_name":{"type":"string","minLength":1,"maxLength":255},"domain":{"type":"string","maxLength":255},"registry_url":{"type":"string","maxLength":512},"ttl_seconds":{"type":"integer","minimum":3600,"maximum":604800},"description":{"type":"string","maxLength":1000},"tags":{"type":"array","items":{"type":"string","maxLength":64},"maxItems":20},"version":{"type":"string","maxLength":64},"publisher":{"type":"object","required":["displayName"],"properties":{"displayName":{"type":"string","minLength":1,"maxLength":255}}},"extensions":{"type":"object","additionalProperties":{"type":"object","additionalProperties":true}},"entry_data":{"type":"object","additionalProperties":true},"trust_manifest":{"anyOf":[{"type":"null"},{"type":"object","additionalProperties":true,"properties":{"identity":{"type":"string"},"identityType":{"type":"string"},"trustSchema":{"type":"object","additionalProperties":true},"attestations":{"type":"array","items":{"type":"object","additionalProperties":true}},"provenance":{"type":"array","items":{"type":"object","additionalProperties":true}},"privacyPolicyUrl":{"type":"string"},"termsOfServiceUrl":{"type":"string"},"signature":{"type":"string"},"metadata":{"type":"object","additionalProperties":true}}}]}}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"org_id","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["org_id","display_name","identifier","extensions","ttl_seconds","status","email_verified","domain_verified","created_at","updated_at"],"properties":{"org_id":{"type":"string"},"display_name":{"type":"string"},"domain":{"type":["null","string"]},"registry_url":{"type":["null","string"]},"ttl_seconds":{"type":"number"},"status":{"type":"string","enum":["pending","active","suspended"]},"email_verified":{"type":"boolean"},"email_verified_at":{"type":["null","string"]},"domain_verified_at":{"type":["null","string"]},"card_validation":{"type":["null","object"],"additionalProperties":true},"domain_verified":{"type":"boolean"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"identifier":{"type":"string"},"media_type":{"type":"string"},"description":{"type":["null","string"]},"tags":{"type":"array","items":{"type":"string"}},"publisher":{"type":"object","properties":{"identifier":{"type":"string"},"displayName":{"type":"string"},"identityType":{"type":"string"}}},"extensions":{"type":"object","additionalProperties":{"type":"object","additionalProperties":true}},"data":{"type":"object","additionalProperties":true},"version":{"type":"string"},"trust_manifest":{"type":"object","additionalProperties":true,"properties":{"identity":{"type":"string"},"identityType":{"type":"string"},"trustSchema":{"type":"object","additionalProperties":true},"attestations":{"type":"array","items":{"type":"object","additionalProperties":true}},"provenance":{"type":"array","items":{"type":"object","additionalProperties":true}},"privacyPolicyUrl":{"type":"string"},"termsOfServiceUrl":{"type":"string"},"signature":{"type":"string"},"metadata":{"type":"object","additionalProperties":true}}},"trust_manifest_verified":{"type":"boolean"},"moderation":{"type":"string","enum":["none","hidden","takedown"]},"representative_queries":{"type":"array","items":{"type":"string"}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"endpoint":{"type":"string"}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"endpoint":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"endpoint":{"type":"string"}}}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"endpoint":{"type":"string"}}}}}}}},"delete":{"summary":"Permanently delete your organization","tags":["orgs"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"org_id","required":true}],"responses":{"204":{"description":"Default Response"},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"endpoint":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"endpoint":{"type":"string"}}}}}}}}},"/api/v1/orgs/{org_id}/domain-challenge":{"post":{"summary":"Issue a DNS TXT challenge to prove domain ownership","tags":["orgs"],"description":"Returns the outstanding challenge while it is unexpired; a new one is issued only after expiry or a domain change.","parameters":[{"schema":{"type":"string"},"in":"path","name":"org_id","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["domain","record_name","record_type","record_value","expires_at"],"properties":{"domain":{"type":"string"},"record_name":{"type":"string"},"record_type":{"type":"string"},"record_value":{"type":"string"},"expires_at":{"type":"string"}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"endpoint":{"type":"string"}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"endpoint":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"endpoint":{"type":"string"}}}}}}}}},"/api/v1/orgs/{org_id}/verify-domain":{"post":{"summary":"Verify the DNS TXT challenge and activate the organization","tags":["orgs"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"org_id","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["org_id","display_name","identifier","extensions","ttl_seconds","status","email_verified","domain_verified","created_at","updated_at"],"properties":{"org_id":{"type":"string"},"display_name":{"type":"string"},"domain":{"type":["null","string"]},"registry_url":{"type":["null","string"]},"ttl_seconds":{"type":"number"},"status":{"type":"string","enum":["pending","active","suspended"]},"email_verified":{"type":"boolean"},"email_verified_at":{"type":["null","string"]},"domain_verified_at":{"type":["null","string"]},"card_validation":{"type":["null","object"],"additionalProperties":true},"domain_verified":{"type":"boolean"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"identifier":{"type":"string"},"media_type":{"type":"string"},"description":{"type":["null","string"]},"tags":{"type":"array","items":{"type":"string"}},"publisher":{"type":"object","properties":{"identifier":{"type":"string"},"displayName":{"type":"string"},"identityType":{"type":"string"}}},"extensions":{"type":"object","additionalProperties":{"type":"object","additionalProperties":true}},"data":{"type":"object","additionalProperties":true},"version":{"type":"string"},"trust_manifest":{"type":"object","additionalProperties":true,"properties":{"identity":{"type":"string"},"identityType":{"type":"string"},"trustSchema":{"type":"object","additionalProperties":true},"attestations":{"type":"array","items":{"type":"object","additionalProperties":true}},"provenance":{"type":"array","items":{"type":"object","additionalProperties":true}},"privacyPolicyUrl":{"type":"string"},"termsOfServiceUrl":{"type":"string"},"signature":{"type":"string"},"metadata":{"type":"object","additionalProperties":true}}},"trust_manifest_verified":{"type":"boolean"},"moderation":{"type":"string","enum":["none","hidden","takedown"]},"representative_queries":{"type":"array","items":{"type":"string"}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"endpoint":{"type":"string"}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"endpoint":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"endpoint":{"type":"string"}}}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"endpoint":{"type":"string"}}}}}}}}},"/api/v1/orgs/{org_id}/resend-verification":{"post":{"summary":"Send a new verification email for an org whose email is not yet verified","tags":["orgs"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"org_id","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["sent"],"properties":{"sent":{"type":"boolean"}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"endpoint":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"endpoint":{"type":"string"}}}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"endpoint":{"type":"string"}}}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"endpoint":{"type":"string"}}}}}}}}},"/api/v1/orgs/{org_id}/suspend":{"delete":{"summary":"Suspend your organization","tags":["orgs"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"org_id","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["org_id","display_name","identifier","extensions","ttl_seconds","status","email_verified","domain_verified","created_at","updated_at"],"properties":{"org_id":{"type":"string"},"display_name":{"type":"string"},"domain":{"type":["null","string"]},"registry_url":{"type":["null","string"]},"ttl_seconds":{"type":"number"},"status":{"type":"string","enum":["pending","active","suspended"]},"email_verified":{"type":"boolean"},"email_verified_at":{"type":["null","string"]},"domain_verified_at":{"type":["null","string"]},"card_validation":{"type":["null","object"],"additionalProperties":true},"domain_verified":{"type":"boolean"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"identifier":{"type":"string"},"media_type":{"type":"string"},"description":{"type":["null","string"]},"tags":{"type":"array","items":{"type":"string"}},"publisher":{"type":"object","properties":{"identifier":{"type":"string"},"displayName":{"type":"string"},"identityType":{"type":"string"}}},"extensions":{"type":"object","additionalProperties":{"type":"object","additionalProperties":true}},"data":{"type":"object","additionalProperties":true},"version":{"type":"string"},"trust_manifest":{"type":"object","additionalProperties":true,"properties":{"identity":{"type":"string"},"identityType":{"type":"string"},"trustSchema":{"type":"object","additionalProperties":true},"attestations":{"type":"array","items":{"type":"object","additionalProperties":true}},"provenance":{"type":"array","items":{"type":"object","additionalProperties":true}},"privacyPolicyUrl":{"type":"string"},"termsOfServiceUrl":{"type":"string"},"signature":{"type":"string"},"metadata":{"type":"object","additionalProperties":true}}},"trust_manifest_verified":{"type":"boolean"},"moderation":{"type":"string","enum":["none","hidden","takedown"]},"representative_queries":{"type":"array","items":{"type":"string"}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"endpoint":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"endpoint":{"type":"string"}}}}}}}}},"/api/v1/orgs/{org_id}/reactivate":{"post":{"summary":"Reactivate a suspended organization","tags":["orgs"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"org_id","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["org_id","display_name","identifier","extensions","ttl_seconds","status","email_verified","domain_verified","created_at","updated_at"],"properties":{"org_id":{"type":"string"},"display_name":{"type":"string"},"domain":{"type":["null","string"]},"registry_url":{"type":["null","string"]},"ttl_seconds":{"type":"number"},"status":{"type":"string","enum":["pending","active","suspended"]},"email_verified":{"type":"boolean"},"email_verified_at":{"type":["null","string"]},"domain_verified_at":{"type":["null","string"]},"card_validation":{"type":["null","object"],"additionalProperties":true},"domain_verified":{"type":"boolean"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"identifier":{"type":"string"},"media_type":{"type":"string"},"description":{"type":["null","string"]},"tags":{"type":"array","items":{"type":"string"}},"publisher":{"type":"object","properties":{"identifier":{"type":"string"},"displayName":{"type":"string"},"identityType":{"type":"string"}}},"extensions":{"type":"object","additionalProperties":{"type":"object","additionalProperties":true}},"data":{"type":"object","additionalProperties":true},"version":{"type":"string"},"trust_manifest":{"type":"object","additionalProperties":true,"properties":{"identity":{"type":"string"},"identityType":{"type":"string"},"trustSchema":{"type":"object","additionalProperties":true},"attestations":{"type":"array","items":{"type":"object","additionalProperties":true}},"provenance":{"type":"array","items":{"type":"object","additionalProperties":true}},"privacyPolicyUrl":{"type":"string"},"termsOfServiceUrl":{"type":"string"},"signature":{"type":"string"},"metadata":{"type":"object","additionalProperties":true}}},"trust_manifest_verified":{"type":"boolean"},"moderation":{"type":"string","enum":["none","hidden","takedown"]},"representative_queries":{"type":"array","items":{"type":"string"}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"endpoint":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"endpoint":{"type":"string"}}}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"endpoint":{"type":"string"}}}}}}}}},"/api/v1/orgs/{org_id}/claim":{"post":{"summary":"Recover an orphaned entry using account-bound DNS or email proof","tags":["orgs"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"token":{"type":"string","pattern":"^[a-f0-9]{64}$"}}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"org_id","required":true}],"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["org_id","display_name","identifier","extensions","ttl_seconds","status","email_verified","domain_verified","created_at","updated_at"],"properties":{"org_id":{"type":"string"},"display_name":{"type":"string"},"domain":{"type":["null","string"]},"registry_url":{"type":["null","string"]},"ttl_seconds":{"type":"number"},"status":{"type":"string","enum":["pending","active","suspended"]},"email_verified":{"type":"boolean"},"email_verified_at":{"type":["null","string"]},"domain_verified_at":{"type":["null","string"]},"card_validation":{"type":["null","object"],"additionalProperties":true},"domain_verified":{"type":"boolean"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"identifier":{"type":"string"},"media_type":{"type":"string"},"description":{"type":["null","string"]},"tags":{"type":"array","items":{"type":"string"}},"publisher":{"type":"object","properties":{"identifier":{"type":"string"},"displayName":{"type":"string"},"identityType":{"type":"string"}}},"extensions":{"type":"object","additionalProperties":{"type":"object","additionalProperties":true}},"data":{"type":"object","additionalProperties":true},"version":{"type":"string"},"trust_manifest":{"type":"object","additionalProperties":true,"properties":{"identity":{"type":"string"},"identityType":{"type":"string"},"trustSchema":{"type":"object","additionalProperties":true},"attestations":{"type":"array","items":{"type":"object","additionalProperties":true}},"provenance":{"type":"array","items":{"type":"object","additionalProperties":true}},"privacyPolicyUrl":{"type":"string"},"termsOfServiceUrl":{"type":"string"},"signature":{"type":"string"},"metadata":{"type":"object","additionalProperties":true}}},"trust_manifest_verified":{"type":"boolean"},"moderation":{"type":"string","enum":["none","hidden","takedown"]},"representative_queries":{"type":"array","items":{"type":"string"}}}}}}},"202":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string"},"method":{"type":"string"},"expires_at":{"type":"string"},"record_name":{"type":"string"},"record_value":{"type":"string"}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"endpoint":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"endpoint":{"type":"string"}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"endpoint":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"endpoint":{"type":"string"}}}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"endpoint":{"type":"string"}}}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"endpoint":{"type":"string"}}}}}}}}},"/api/v1/admin/orgs/{org_id}/moderation":{"post":{"summary":"Set an entry's operator moderation (none | hidden | takedown)","tags":["admin"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["moderation"],"additionalProperties":false,"properties":{"moderation":{"type":"string","enum":["none","hidden","takedown"]}}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"org_id","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["org_id","display_name","identifier","extensions","ttl_seconds","status","email_verified","domain_verified","created_at","updated_at"],"properties":{"org_id":{"type":"string"},"display_name":{"type":"string"},"domain":{"type":["null","string"]},"registry_url":{"type":["null","string"]},"ttl_seconds":{"type":"number"},"status":{"type":"string","enum":["pending","active","suspended"]},"email_verified":{"type":"boolean"},"email_verified_at":{"type":["null","string"]},"domain_verified_at":{"type":["null","string"]},"card_validation":{"type":["null","object"],"additionalProperties":true},"domain_verified":{"type":"boolean"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"identifier":{"type":"string"},"media_type":{"type":"string"},"description":{"type":["null","string"]},"tags":{"type":"array","items":{"type":"string"}},"publisher":{"type":"object","properties":{"identifier":{"type":"string"},"displayName":{"type":"string"},"identityType":{"type":"string"}}},"extensions":{"type":"object","additionalProperties":{"type":"object","additionalProperties":true}},"data":{"type":"object","additionalProperties":true},"version":{"type":"string"},"trust_manifest":{"type":"object","additionalProperties":true,"properties":{"identity":{"type":"string"},"identityType":{"type":"string"},"trustSchema":{"type":"object","additionalProperties":true},"attestations":{"type":"array","items":{"type":"object","additionalProperties":true}},"provenance":{"type":"array","items":{"type":"object","additionalProperties":true}},"privacyPolicyUrl":{"type":"string"},"termsOfServiceUrl":{"type":"string"},"signature":{"type":"string"},"metadata":{"type":"object","additionalProperties":true}}},"trust_manifest_verified":{"type":"boolean"},"moderation":{"type":"string","enum":["none","hidden","takedown"]},"representative_queries":{"type":"array","items":{"type":"string"}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"endpoint":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"endpoint":{"type":"string"}}}}}}}}},"/api/v1/admin/orgs/moderation-bulk":{"post":{"summary":"Set operator moderation on every entry whose org_id starts with a prefix","tags":["admin"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["org_id_prefix","moderation"],"additionalProperties":false,"properties":{"org_id_prefix":{"type":"string","minLength":3,"maxLength":64,"pattern":"^[a-z0-9-]+$"},"moderation":{"type":"string","enum":["none","hidden","takedown"]}}}}}},"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["org_id_prefix","moderation","count","org_ids"],"properties":{"org_id_prefix":{"type":"string"},"moderation":{"type":"string","enum":["none","hidden","takedown"]},"count":{"type":"integer","minimum":0},"org_ids":{"type":"array","items":{"type":"string"}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"endpoint":{"type":"string"}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"endpoint":{"type":"string"}}}}}}}}},"/api/v1/availability":{"get":{"summary":"Check whether an org_id and/or domain is still free to register","tags":["orgs"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":64},"in":"query","name":"org_id","required":false},{"schema":{"type":"string","minLength":1,"maxLength":255},"in":"query","name":"domain","required":false}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"org_id_available":{"type":"boolean"},"domain_available":{"type":"boolean"}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"endpoint":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"endpoint":{"type":"string"}}}}}}}}},"/api/v1/search":{"get":{"tags":["search"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":128},"in":"query","name":"q","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["query","count","results"],"additionalProperties":false,"properties":{"query":{"type":"string","minLength":1,"maxLength":128},"count":{"type":"integer","minimum":0},"results":{"type":"array","items":{"type":"object","required":["org_id","display_name","identifier","extensions","ttl_seconds","status","email_verified","domain_verified","created_at","updated_at"],"properties":{"org_id":{"type":"string"},"display_name":{"type":"string"},"domain":{"type":["null","string"]},"registry_url":{"type":["null","string"]},"ttl_seconds":{"type":"number"},"status":{"type":"string","enum":["pending","active","suspended"]},"email_verified":{"type":"boolean"},"email_verified_at":{"type":["null","string"]},"domain_verified_at":{"type":["null","string"]},"card_validation":{"type":["null","object"],"additionalProperties":true},"domain_verified":{"type":"boolean"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"identifier":{"type":"string"},"media_type":{"type":"string"},"description":{"type":["null","string"]},"tags":{"type":"array","items":{"type":"string"}},"publisher":{"type":"object","properties":{"identifier":{"type":"string"},"displayName":{"type":"string"},"identityType":{"type":"string"}}},"extensions":{"type":"object","additionalProperties":{"type":"object","additionalProperties":true}},"data":{"type":"object","additionalProperties":true},"version":{"type":"string"},"trust_manifest":{"type":"object","additionalProperties":true,"properties":{"identity":{"type":"string"},"identityType":{"type":"string"},"trustSchema":{"type":"object","additionalProperties":true},"attestations":{"type":"array","items":{"type":"object","additionalProperties":true}},"provenance":{"type":"array","items":{"type":"object","additionalProperties":true}},"privacyPolicyUrl":{"type":"string"},"termsOfServiceUrl":{"type":"string"},"signature":{"type":"string"},"metadata":{"type":"object","additionalProperties":true}}},"trust_manifest_verified":{"type":"boolean"},"moderation":{"type":"string","enum":["none","hidden","takedown"]},"representative_queries":{"type":"array","items":{"type":"string"}}}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"endpoint":{"type":"string"}}}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"endpoint":{"type":"string"}}}}}}}}},"/api/v1/agentic-search":{"get":{"tags":["search"],"parameters":[{"schema":{"type":"string","minLength":2,"maxLength":128},"in":"query","name":"q","required":true},{"schema":{"type":"integer","minimum":1,"maximum":50},"in":"query","name":"limit","required":false}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["query","count","candidates","resolved","referrals","orgsQueried","orgsUnreachable","tookMs"],"additionalProperties":false,"properties":{"query":{"type":"string"},"count":{"type":"integer","minimum":0},"candidates":{"type":"array","items":{"type":"object","required":["identifier","displayName","type","url","description","tags","provenance","score"],"properties":{"identifier":{"type":"string"},"displayName":{"type":"string"},"type":{"type":"string"},"url":{"type":"string"},"description":{"type":["null","string"]},"tags":{"type":"array","items":{"type":"string"}},"publisher":{"type":"object","properties":{"identifier":{"type":"string"},"displayName":{"type":"string"},"identityType":{"type":"string"}}},"trustManifest":{"type":"object","additionalProperties":true,"properties":{"identity":{"type":"string"},"identityType":{"type":"string"},"trustSchema":{"type":"object","additionalProperties":true},"attestations":{"type":"array","items":{"type":"object","additionalProperties":true}},"provenance":{"type":"array","items":{"type":"object","additionalProperties":true}},"privacyPolicyUrl":{"type":"string"},"termsOfServiceUrl":{"type":"string"},"signature":{"type":"string"},"metadata":{"type":"object","additionalProperties":true}}},"trustManifestVerified":{"type":"boolean"},"provenance":{"type":"object","required":["orgId","registryUrl","basis"],"properties":{"orgId":{"type":"string"},"registryUrl":{"type":"string"},"basis":{"type":"string","enum":["agent_search","single_agent_org","federated"]}}},"score":{"type":"number"}}}},"resolved":{"anyOf":[{"type":"object","required":["identifier","displayName","type","url","description","tags","provenance","score"],"properties":{"identifier":{"type":"string"},"displayName":{"type":"string"},"type":{"type":"string"},"url":{"type":"string"},"description":{"type":["null","string"]},"tags":{"type":"array","items":{"type":"string"}},"publisher":{"type":"object","properties":{"identifier":{"type":"string"},"displayName":{"type":"string"},"identityType":{"type":"string"}}},"trustManifest":{"type":"object","additionalProperties":true,"properties":{"identity":{"type":"string"},"identityType":{"type":"string"},"trustSchema":{"type":"object","additionalProperties":true},"attestations":{"type":"array","items":{"type":"object","additionalProperties":true}},"provenance":{"type":"array","items":{"type":"object","additionalProperties":true}},"privacyPolicyUrl":{"type":"string"},"termsOfServiceUrl":{"type":"string"},"signature":{"type":"string"},"metadata":{"type":"object","additionalProperties":true}}},"trustManifestVerified":{"type":"boolean"},"provenance":{"type":"object","required":["orgId","registryUrl","basis"],"properties":{"orgId":{"type":"string"},"registryUrl":{"type":"string"},"basis":{"type":"string","enum":["agent_search","single_agent_org","federated"]}}},"score":{"type":"number"}}},{"type":"null"}]},"referrals":{"type":"array","items":{"type":"object","required":["identifier","displayName","searchUrl"],"properties":{"identifier":{"type":"string"},"displayName":{"type":"string"},"searchUrl":{"type":"string"}}}},"orgsQueried":{"type":"integer","minimum":0},"orgsUnreachable":{"type":"array","items":{"type":"string"}},"tookMs":{"type":"integer","minimum":0}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"endpoint":{"type":"string"}}}}}}}}},"/api/ard":{"get":{"responses":{"200":{"description":"Default Response"}}}},"/api/ard/search":{"post":{"tags":["ard"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["query"],"additionalProperties":true,"properties":{"query":{"type":"object","required":["text"],"additionalProperties":true,"properties":{"text":{"type":"string","minLength":1,"maxLength":512},"filter":{"type":"object","additionalProperties":true,"properties":{"type":{"type":"array","items":{"type":"string"}}}}}},"pageSize":{"type":"integer","minimum":1,"maximum":100}}}}}},"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["results","referrals","pageToken"],"additionalProperties":false,"properties":{"results":{"type":"array","items":{"type":"object","required":["identifier","displayName","type","url","score"],"additionalProperties":true,"properties":{"identifier":{"type":"string"},"displayName":{"type":"string"},"type":{"type":"string"},"url":{"type":"string"},"description":{"type":["null","string"]},"tags":{"type":"array","items":{"type":"string"}},"publisher":{"type":"object","additionalProperties":true},"extensions":{"type":"object","additionalProperties":{"type":"object","additionalProperties":true}},"provenance":{"type":"object","additionalProperties":true},"score":{"type":"number"}}}},"referrals":{"type":"array","items":{"type":"object","required":["displayName","searchUrl"],"properties":{"identifier":{"type":"string"},"displayName":{"type":"string"},"searchUrl":{"type":"string"}}}},"pageToken":{"type":["null","string"]}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"endpoint":{"type":"string"}}}}}}}}},"/api/ard/explore":{"post":{"tags":["ard"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["resultType"],"additionalProperties":true,"properties":{"resultType":{"type":"object","required":["facets"],"properties":{"facets":{"type":"array","items":{"type":"object","required":["field"],"properties":{"field":{"type":"string","enum":["type","tags"]}}}}}}}}}}},"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["resultType","scope","facets"],"additionalProperties":false,"properties":{"resultType":{"type":"string","enum":["facets"]},"scope":{"type":"string","enum":["organizations"]},"facets":{"type":"object","additionalProperties":{"type":"object","required":["buckets"],"properties":{"buckets":{"type":"array","items":{"type":"object","required":["value","count"],"properties":{"value":{"type":"string"},"count":{"type":"integer"}}}}}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"endpoint":{"type":"string"}}}}}}}}},"/api/ard/agents":{"get":{"tags":["ard"],"parameters":[{"schema":{"type":"string","maxLength":256},"in":"query","name":"filter","required":false},{"schema":{"type":"string"},"in":"query","name":"orderBy","required":false},{"schema":{"type":"integer","minimum":1,"maximum":100},"in":"query","name":"pageSize","required":false},{"schema":{"type":"string"},"in":"query","name":"pageToken","required":false}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["items","pageToken"],"additionalProperties":false,"properties":{"items":{"type":"array","items":{"type":"object","required":["identifier","displayName","type","url","score"],"additionalProperties":true,"properties":{"identifier":{"type":"string"},"displayName":{"type":"string"},"type":{"type":"string"},"url":{"type":"string"},"description":{"type":["null","string"]},"tags":{"type":"array","items":{"type":"string"}},"publisher":{"type":"object","additionalProperties":true},"extensions":{"type":"object","additionalProperties":{"type":"object","additionalProperties":true}},"provenance":{"type":"object","additionalProperties":true},"score":{"type":"number"}}}},"pageToken":{"type":["null","string"]}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"endpoint":{"type":"string"}}}}}}}}},"/api/v1/resolve":{"get":{"tags":["resolve"],"parameters":[{"schema":{"type":"string","minLength":1},"in":"query","name":"locator","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["locator","identifier","match","entry"],"properties":{"locator":{"type":"string","minLength":1},"identifier":{"type":"string","minLength":1},"match":{"type":"string","enum":["exact","publisher"]},"entry":{"type":"object","required":["identifier","displayName","type","tags","updatedAt","extensions"],"additionalProperties":false,"properties":{"identifier":{"type":"string"},"displayName":{"type":"string"},"type":{"type":"string"},"url":{"type":"string"},"data":{"type":"object","additionalProperties":true},"description":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"version":{"type":"string"},"publisher":{"type":"object","properties":{"identifier":{"type":"string"},"displayName":{"type":"string"},"identityType":{"type":"string"}}},"trustManifest":{"type":"object","additionalProperties":true,"properties":{"identity":{"type":"string"},"identityType":{"type":"string"},"trustSchema":{"type":"object","additionalProperties":true},"attestations":{"type":"array","items":{"type":"object","additionalProperties":true}},"provenance":{"type":"array","items":{"type":"object","additionalProperties":true}},"privacyPolicyUrl":{"type":"string"},"termsOfServiceUrl":{"type":"string"},"signature":{"type":"string"},"metadata":{"type":"object","additionalProperties":true}}},"trustManifestVerified":{"type":"boolean"},"updatedAt":{"type":"string"},"extensions":{"type":"object","additionalProperties":{"type":"object","additionalProperties":true}}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"endpoint":{"type":"string"}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"string"},"detail":{"type":"string"},"field":{"type":"string"},"endpoint":{"type":"string"}}}}}}}}}},"servers":[{"url":"http://localhost:3001","description":"local dev"}],"tags":[{"name":"health","description":"Liveness and readiness probes"},{"name":"auth","description":"OAuth login and email verification"},{"name":"index","description":"Public index record lookup"},{"name":"orgs","description":"Authenticated org management"},{"name":"search","description":"Keyword search"},{"name":"resolve","description":"2-hop agent resolution"}]}