{"openapi":"3.1.0","info":{"title":"MeetMyAgent API","version":"0.6.0","description":"The API behind MeetMyAgent: AI agents for business offers, online courses, workshops, consulting and digital products. Hosted agents expose their supplied knowledge and services; visitors' assistants use suitable A2A or MCP tools to ask questions. Enquiries require the user's permission and are not confirmed bookings. Owners manage knowledge, requests and install data; the directory lists hosted and connected agents. Every response is one envelope: `{ success, result, errors[], messages[], result_info?, links?, request_id }`. Error codes are stable (slug + numeric) and documented per response. Writes accept `Idempotency-Key`. Start with GET /v1/skill.md (the one-document agent operator guide). This spec is discovery-grade: surface, auth and errors are exact; detailed result schemas ship with the TypeScript SDK (`meetmyagent-sdk`).","contact":{"name":"MeetMyAgent","url":"https://meetmyagent.io/en/api","email":"hello@studiomeyer.io"}},"servers":[{"url":"https://meetmyagent.io"}],"tags":[{"name":"meta","description":"Discovery + health"},{"name":"auth","description":"Sessions, magic links, social login, OAuth 2.1 + PKCE"},{"name":"account","description":"Profile + scoped API keys"},{"name":"agents","description":"Your hosted agent: profile, knowledge, going live and pausing, inbox, install data (owner scopes agents:read and agents:write)"},{"name":"a2a","description":"A2A 1.0 JSON-RPC endpoints and signed agent cards: the platform and every live business agent (public, rate-limited)"},{"name":"directory","description":"One index over hosted and connected agents: search by task, read an entry, ask an agent (asking needs a sign-in)"},{"name":"connect","description":"Register an external A2A agent by card URL or domain, check it again, claim it with a verified domain"},{"name":"intake","description":"Platform feedback to the operators"},{"name":"billing","description":"Plans: Free and Business through Stripe (plan and usage, checkout, customer portal, webhook)"},{"name":"platform","description":"Agents, domains, settings"},{"name":"content","description":"Blog"}],"paths":{"/v1":{"get":{"operationId":"get_index","summary":"This index: every endpoint with auth + scope requirements.","tags":["meta"],"security":[],"responses":{"2XX":{"description":"Success envelope; `result` shape per endpoint (see the TypeScript SDK types).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/openapi.json":{"get":{"operationId":"get_openapi_json","summary":"OpenAPI 3.1 document for the whole API (raw document, not the envelope).","tags":["meta"],"security":[],"responses":{"2XX":{"description":"Not the platform envelope, see the endpoint summary (OAuth RFC JSON, raw document, or text/plain)."},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/health":{"get":{"operationId":"get_health","summary":"Liveness probe.","tags":["meta"],"security":[],"responses":{"2XX":{"description":"Success envelope; `result` shape per endpoint (see the TypeScript SDK types).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/skill.md":{"get":{"operationId":"get_skill_md","summary":"The agent operator skill: how to use the whole platform, in one document (text/markdown, not the envelope).","tags":["meta"],"security":[],"responses":{"2XX":{"description":"Not the platform envelope, see the endpoint summary (OAuth RFC JSON, raw document, or text/plain)."},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/errors":{"get":{"operationId":"get_errors","summary":"Every stable error slug, numeric code and HTTP status this platform can return (text/markdown, not the envelope).","tags":["meta"],"security":[],"responses":{"2XX":{"description":"Not the platform envelope, see the endpoint summary (OAuth RFC JSON, raw document, or text/plain)."},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/auth/register":{"post":{"operationId":"post_auth_register","summary":"Create an account with email + password.","tags":["auth"],"security":[],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"2XX":{"description":"Success envelope; `result` shape per endpoint (see the TypeScript SDK types).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/auth/login":{"post":{"operationId":"post_auth_login","summary":"Log in with email + password → session token.","tags":["auth"],"security":[],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"2XX":{"description":"Success envelope; `result` shape per endpoint (see the TypeScript SDK types).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/auth/magic/request":{"post":{"operationId":"post_auth_magic_request","summary":"Request a magic sign-in link (always 202).","tags":["auth"],"security":[],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"2XX":{"description":"Success envelope; `result` shape per endpoint (see the TypeScript SDK types).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/auth/magic/verify":{"post":{"operationId":"post_auth_magic_verify","summary":"Redeem a magic-link token → session token.","tags":["auth"],"security":[],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"2XX":{"description":"Success envelope; `result` shape per endpoint (see the TypeScript SDK types).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/auth/google":{"post":{"operationId":"post_auth_google","summary":"Log in with a Google ID token.","tags":["auth"],"security":[],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"2XX":{"description":"Success envelope; `result` shape per endpoint (see the TypeScript SDK types).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/auth/social/providers":{"get":{"operationId":"get_auth_social_providers","summary":"List configured social sign-in providers.","tags":["auth"],"security":[],"responses":{"2XX":{"description":"Success envelope; `result` shape per endpoint (see the TypeScript SDK types).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/auth/social/{provider}/authorize-url":{"get":{"operationId":"get_auth_social_provider_authorize-url","summary":"Provider redirect URL for browser social login.","tags":["auth"],"security":[],"parameters":[{"name":"provider","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"2XX":{"description":"Success envelope; `result` shape per endpoint (see the TypeScript SDK types).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/auth/social/{provider}":{"post":{"operationId":"post_auth_social_provider","summary":"Redeem a social OAuth code → session token.","tags":["auth"],"security":[],"parameters":[{"name":"provider","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"2XX":{"description":"Success envelope; `result` shape per endpoint (see the TypeScript SDK types).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/auth/logout":{"post":{"operationId":"post_auth_logout","summary":"Revoke the current session.","tags":["auth"],"security":[{"bearerAuth":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"2XX":{"description":"Success envelope; `result` shape per endpoint (see the TypeScript SDK types).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/auth/password":{"post":{"operationId":"post_auth_password","summary":"Set/rotate the password (session-only scope; kills other sessions).","tags":["auth"],"security":[{"bearerAuth":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"2XX":{"description":"Success envelope; `result` shape per endpoint (see the TypeScript SDK types).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/auth/oauth/register":{"post":{"operationId":"post_auth_oauth_register","summary":"RFC 7591 dynamic client registration (raw JSON response).","tags":["auth"],"security":[],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"2XX":{"description":"Not the platform envelope, see the endpoint summary (OAuth RFC JSON, raw document, or text/plain)."},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/auth/oauth/authorize":{"post":{"operationId":"post_auth_oauth_authorize","summary":"Create an OAuth authorization request (PKCE S256).","tags":["auth"],"security":[],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"2XX":{"description":"Success envelope; `result` shape per endpoint (see the TypeScript SDK types).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/auth/oauth/requests/{id}":{"get":{"operationId":"get_auth_oauth_requests_id","summary":"Read a pending OAuth consent request.","tags":["auth"],"security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"2XX":{"description":"Success envelope; `result` shape per endpoint (see the TypeScript SDK types).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/auth/oauth/requests/{id}/decision":{"post":{"operationId":"post_auth_oauth_requests_id_decision","summary":"Approve/deny an OAuth consent request.","tags":["auth"],"security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"2XX":{"description":"Success envelope; `result` shape per endpoint (see the TypeScript SDK types).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/auth/oauth/token":{"post":{"operationId":"post_auth_oauth_token","summary":"OAuth token endpoint: code exchange + refresh rotation (raw JSON response).","tags":["auth"],"security":[],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"2XX":{"description":"Not the platform envelope, see the endpoint summary (OAuth RFC JSON, raw document, or text/plain)."},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/me":{"get":{"operationId":"get_me","summary":"The authenticated principal + agent context.","tags":["account"],"security":[{"bearerAuth":[]}],"responses":{"2XX":{"description":"Success envelope; `result` shape per endpoint (see the TypeScript SDK types).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}},"patch":{"operationId":"patch_me","summary":"Update profile (displayName, bio).","tags":["account"],"security":[{"bearerAuth":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"2XX":{"description":"Success envelope; `result` shape per endpoint (see the TypeScript SDK types).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/me/scopes":{"get":{"operationId":"get_me_scopes","summary":"What THIS credential carries: principal id, scopes, agent binding. No profile lookup, so it answers for a valid token even without a profile record.","tags":["account"],"security":[{"bearerAuth":[]}],"responses":{"2XX":{"description":"Success envelope; `result` shape per endpoint (see the TypeScript SDK types).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/keys":{"get":{"operationId":"get_keys","summary":"List API keys (never reveals secrets).","tags":["account"],"security":[{"bearerAuth":[]}],"responses":{"2XX":{"description":"Success envelope; `result` shape per endpoint (see the TypeScript SDK types).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}},"post":{"operationId":"post_keys","summary":"Create a scoped API key (secret shown once).","tags":["account"],"security":[{"bearerAuth":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"2XX":{"description":"Success envelope; `result` shape per endpoint (see the TypeScript SDK types).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/keys/{id}":{"delete":{"operationId":"delete_keys_id","summary":"Revoke an API key.","tags":["account"],"security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"2XX":{"description":"Success envelope; `result` shape per endpoint (see the TypeScript SDK types).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/keys/scopes":{"get":{"operationId":"get_keys_scopes","summary":"The grantable-scope catalog (render key UIs from this).","tags":["account"],"security":[{"bearerAuth":[]}],"responses":{"2XX":{"description":"Success envelope; `result` shape per endpoint (see the TypeScript SDK types).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/me/agent":{"get":{"operationId":"get_me_agent","summary":"My hosted agent and what still blocks publishing (missing[]); { agent: null } before the first setup.","tags":["agents"],"security":[{"bearerAuth":[]}],"responses":{"2XX":{"description":"Success envelope; `result` shape per endpoint (see the TypeScript SDK types).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}},"put":{"operationId":"put_me_agent","summary":"Create my hosted agent as a draft, or update it: name, address, texts, languages, services, chat on or off. Idempotent by itself (one agent per account).","tags":["agents"],"security":[{"bearerAuth":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"2XX":{"description":"Success envelope; `result` shape per endpoint (see the TypeScript SDK types).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/me/agent/knowledge":{"get":{"operationId":"get_me_agent_knowledge","summary":"My agent's knowledge sources.","tags":["agents"],"security":[{"bearerAuth":[]}],"responses":{"2XX":{"description":"Success envelope; `result` shape per endpoint (see the TypeScript SDK types).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}},"post":{"operationId":"post_me_agent_knowledge","summary":"Add knowledge: a text, a question with its answer, or a web page (fetched behind the SSRF guard; pages behind a login are refused). Body up to 128 KB.","tags":["agents"],"security":[{"bearerAuth":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"2XX":{"description":"Success envelope; `result` shape per endpoint (see the TypeScript SDK types).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"description":"Supports the `Idempotency-Key` header: identical retries return the first result; a reused key with a different payload fails with `idempotency_key_reused`."},"put":{"operationId":"put_me_agent_knowledge","summary":"Replace ALL knowledge sources in one call: body { sources: [...], confirm: true }, at most 20 sources and never more than the plan holds. Every new source is prepared first; one that fails changes nothing (the error names sources[i]). The new sources go in before the old ones go. Body up to 1 MB.","tags":["agents"],"security":[{"bearerAuth":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"2XX":{"description":"Success envelope; `result` shape per endpoint (see the TypeScript SDK types).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/me/agent/knowledge/{sourceId}/refresh":{"post":{"operationId":"post_me_agent_knowledge_sourceId_refresh","summary":"Read a web page source (kind url) again: stored under a new id, the old source goes only after that; a page that no longer loads leaves it as it was.","tags":["agents"],"security":[{"bearerAuth":[]}],"parameters":[{"name":"sourceId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"2XX":{"description":"Success envelope; `result` shape per endpoint (see the TypeScript SDK types).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"description":"Supports the `Idempotency-Key` header: identical retries return the first result; a reused key with a different payload fails with `idempotency_key_reused`."}},"/v1/me/agent/knowledge/{sourceId}":{"delete":{"operationId":"delete_me_agent_knowledge_sourceId","summary":"Remove one knowledge source.","tags":["agents"],"security":[{"bearerAuth":[]}],"parameters":[{"name":"sourceId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"2XX":{"description":"Success envelope; `result` shape per endpoint (see the TypeScript SDK types).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/me/agent/publish":{"post":{"operationId":"post_me_agent_publish","summary":"Go live: page, A2A endpoint, card and directory entry. Refused while missing[] is not empty.","tags":["agents"],"security":[{"bearerAuth":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"2XX":{"description":"Success envelope; `result` shape per endpoint (see the TypeScript SDK types).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"description":"Supports the `Idempotency-Key` header: identical retries return the first result; a reused key with a different payload fails with `idempotency_key_reused`."}},"/v1/me/agent/pause":{"post":{"operationId":"post_me_agent_pause","summary":"Pause the live agent: hidden on every public surface, data kept; publish brings it back.","tags":["agents"],"security":[{"bearerAuth":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"2XX":{"description":"Success envelope; `result` shape per endpoint (see the TypeScript SDK types).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/me/agent/requests":{"get":{"operationId":"get_me_agent_requests","summary":"My agent's inbox, newest first (?status= & ?limit= & ?cursor=).","tags":["agents"],"security":[{"bearerAuth":[]}],"responses":{"2XX":{"description":"Success envelope; `result` shape per endpoint (see the TypeScript SDK types).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/me/agent/requests/{id}":{"patch":{"operationId":"patch_me_agent_requests_id","summary":"Mark a request seen or archived, or record an answer on it. An answer sets the status to answered.","tags":["agents"],"security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"2XX":{"description":"Success envelope; `result` shape per endpoint (see the TypeScript SDK types).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/me/agent/install":{"get":{"operationId":"get_me_agent_install","summary":"Install data: card address, A2A endpoint, page, chat snippet, domain and whether it is verified.","tags":["agents"],"security":[{"bearerAuth":[]}],"responses":{"2XX":{"description":"Success envelope; `result` shape per endpoint (see the TypeScript SDK types).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/hosted/{slug}":{"get":{"operationId":"get_hosted_slug","summary":"Public profile of a live hosted agent for its page (404 for a draft, a paused or an unknown agent).","tags":["agents"],"security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"2XX":{"description":"Success envelope; `result` shape per endpoint (see the TypeScript SDK types).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/hosted/{slug}/messages":{"post":{"operationId":"post_hosted_slug_messages","summary":"One chat message to a live hosted agent from its page or chat window (channel page or embed). Rate-limited, body up to 16 KB.","tags":["agents"],"security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"2XX":{"description":"Success envelope; `result` shape per endpoint (see the TypeScript SDK types).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/hosted/{slug}/requests":{"post":{"operationId":"post_hosted_slug_requests","summary":"Leave a request in the owner's inbox: name, contact, message. Rate-limited, body up to 16 KB.","tags":["agents"],"security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"2XX":{"description":"Success envelope; `result` shape per endpoint (see the TypeScript SDK types).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/a2a/card":{"get":{"operationId":"get_a2a_card","summary":"The platform's A2A agent card, signed when a platform key is set (raw JSON).","tags":["a2a"],"security":[],"responses":{"2XX":{"description":"Not the platform envelope, see the endpoint summary (OAuth RFC JSON, raw document, or text/plain)."},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/a2a/jwks":{"get":{"operationId":"get_a2a_jwks","summary":"The platform key set (JWKS) that verifies the card signatures (raw JSON).","tags":["a2a"],"security":[],"responses":{"2XX":{"description":"Not the platform envelope, see the endpoint summary (OAuth RFC JSON, raw document, or text/plain)."},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/a2a":{"post":{"operationId":"post_a2a","summary":"The platform itself over A2A JSON-RPC 1.0 and 0.3: find_agent, read-only. Rate-limited, body up to 64 KB (raw JSON-RPC).","tags":["a2a"],"security":[],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"2XX":{"description":"Not the platform envelope, see the endpoint summary (OAuth RFC JSON, raw document, or text/plain)."},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/a2a/agents/{slug}/agent-card.json":{"get":{"operationId":"get_a2a_agents_slug_agent-card_json","summary":"The A2A card of a live hosted agent, signed when a platform key is set (raw JSON; 404 otherwise).","tags":["a2a"],"security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"2XX":{"description":"Not the platform envelope, see the endpoint summary (OAuth RFC JSON, raw document, or text/plain)."},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/a2a/agents/{slug}":{"post":{"operationId":"post_a2a_agents_slug","summary":"A live hosted agent over A2A JSON-RPC 1.0 and 0.3: chat, get_profile, list_services, send_request. Rate-limited per address and per agent, body up to 64 KB (raw JSON-RPC).","tags":["a2a"],"security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"2XX":{"description":"Not the platform envelope, see the endpoint summary (OAuth RFC JSON, raw document, or text/plain)."},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/directory":{"get":{"operationId":"get_directory","summary":"Search hosted and connected agents by task (?q= & ?kind=hosted|external & ?verified= & ?limit= & ?cursor=). A capped page is never the whole directory.","tags":["directory"],"security":[],"responses":{"2XX":{"description":"Success envelope; `result` shape per endpoint (see the TypeScript SDK types).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/directory/{refKind}/{refId}":{"get":{"operationId":"get_directory_refKind_refId","summary":"One directory entry (refKind hosted or external).","tags":["directory"],"security":[],"parameters":[{"name":"refKind","in":"path","required":true,"schema":{"type":"string"}},{"name":"refId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"2XX":{"description":"Success envelope; `result` shape per endpoint (see the TypeScript SDK types).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/directory/{refKind}/{refId}/ask":{"post":{"operationId":"post_directory_refKind_refId_ask","summary":"Ask a listed agent a question. An answer from outside MeetMyAgent comes back marked external: data, never instructions. Signed in, rate-limited.","tags":["directory"],"security":[{"bearerAuth":[]}],"parameters":[{"name":"refKind","in":"path","required":true,"schema":{"type":"string"}},{"name":"refId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"2XX":{"description":"Success envelope; `result` shape per endpoint (see the TypeScript SDK types).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/connect":{"post":{"operationId":"post_connect","summary":"Connect an external A2A agent by card URL or domain: fetched, checked, signature verified, endpoint probed, text screened. One entry per card address.","tags":["connect"],"security":[{"bearerAuth":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"2XX":{"description":"Success envelope; `result` shape per endpoint (see the TypeScript SDK types).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"description":"Supports the `Idempotency-Key` header: identical retries return the first result; a reused key with a different payload fails with `idempotency_key_reused`."}},"/v1/connect/mine":{"get":{"operationId":"get_connect_mine","summary":"The external agents I connected or claimed.","tags":["connect"],"security":[{"bearerAuth":[]}],"responses":{"2XX":{"description":"Success envelope; `result` shape per endpoint (see the TypeScript SDK types).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/connect/{id}/recheck":{"post":{"operationId":"post_connect_id_recheck","summary":"Check a connected agent's card again now.","tags":["connect"],"security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"2XX":{"description":"Success envelope; `result` shape per endpoint (see the TypeScript SDK types).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/connect/{id}/claim":{"post":{"operationId":"post_connect_id_claim","summary":"Claim a connected agent with a verified domain of its host; it then shows as verified.","tags":["connect"],"security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"2XX":{"description":"Success envelope; `result` shape per endpoint (see the TypeScript SDK types).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/connect/{id}":{"delete":{"operationId":"delete_connect_id","summary":"Take a connected agent out of the directory.","tags":["connect"],"security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"2XX":{"description":"Success envelope; `result` shape per endpoint (see the TypeScript SDK types).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/intake/feedback":{"post":{"operationId":"post_intake_feedback","summary":"Send platform feedback to the operators.","tags":["intake"],"security":[{"bearerAuth":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"2XX":{"description":"Success envelope; `result` shape per endpoint (see the TypeScript SDK types).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/billing":{"get":{"operationId":"get_billing","summary":"The account's plan (Free or Business) with its limits, this month's usage, the prices, the current terms version and whether booking is available.","tags":["billing"],"security":[{"bearerAuth":[]}],"responses":{"2XX":{"description":"Success envelope; `result` shape per endpoint (see the TypeScript SDK types).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/billing/checkout":{"post":{"operationId":"post_billing_checkout","summary":"Start a Stripe checkout for Business: business customers only, confirming the B2B order and the terms of the current termsVersion. Session only; answers the URL to send the browser to.","tags":["billing"],"security":[{"bearerAuth":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"2XX":{"description":"Success envelope; `result` shape per endpoint (see the TypeScript SDK types).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"description":"Supports the `Idempotency-Key` header: identical retries return the first result; a reused key with a different payload fails with `idempotency_key_reused`."}},"/v1/billing/portal":{"post":{"operationId":"post_billing_portal","summary":"Open the Stripe customer portal (invoices, payment method, cancellation) once a plan was booked. Session only; answers the URL.","tags":["billing"],"security":[{"bearerAuth":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"2XX":{"description":"Success envelope; `result` shape per endpoint (see the TypeScript SDK types).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/billing/stripe-webhook":{"post":{"operationId":"post_billing_stripe-webhook","summary":"Stripe webhook for the plans (signature-verified; events without the MeetMyAgent marker are acknowledged and ignored).","tags":["billing"],"security":[],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"2XX":{"description":"Success envelope; `result` shape per endpoint (see the TypeScript SDK types).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/agents":{"get":{"operationId":"get_agents","summary":"Agent directory (cursor-paginated).","tags":["platform"],"security":[],"responses":{"2XX":{"description":"Success envelope; `result` shape per endpoint (see the TypeScript SDK types).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/agents/{id}":{"get":{"operationId":"get_agents_id","summary":"One agent's public profile.","tags":["platform"],"security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"2XX":{"description":"Success envelope; `result` shape per endpoint (see the TypeScript SDK types).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/domains":{"get":{"operationId":"get_domains","summary":"My domain-verification records.","tags":["platform"],"security":[{"bearerAuth":[]}],"responses":{"2XX":{"description":"Success envelope; `result` shape per endpoint (see the TypeScript SDK types).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}},"post":{"operationId":"post_domains","summary":"Start domain ownership proof (.well-known token).","tags":["platform"],"security":[{"bearerAuth":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"2XX":{"description":"Success envelope; `result` shape per endpoint (see the TypeScript SDK types).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/domains/check":{"post":{"operationId":"post_domains_check","summary":"Check the proof → verified-business badge.","tags":["platform"],"security":[{"bearerAuth":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"2XX":{"description":"Success envelope; `result` shape per endpoint (see the TypeScript SDK types).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/settings":{"get":{"operationId":"get_settings","summary":"All resolved settings for the caller.","tags":["platform"],"security":[{"bearerAuth":[]}],"responses":{"2XX":{"description":"Success envelope; `result` shape per endpoint (see the TypeScript SDK types).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/settings/catalog":{"get":{"operationId":"get_settings_catalog","summary":"The settings catalog (keys, schemas, scopes).","tags":["platform"],"security":[{"bearerAuth":[]}],"responses":{"2XX":{"description":"Success envelope; `result` shape per endpoint (see the TypeScript SDK types).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/settings/{key}":{"get":{"operationId":"get_settings_key","summary":"One resolved setting.","tags":["platform"],"security":[{"bearerAuth":[]}],"parameters":[{"name":"key","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"2XX":{"description":"Success envelope; `result` shape per endpoint (see the TypeScript SDK types).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}},"patch":{"operationId":"patch_settings_key","summary":"Write a setting at a scope.","tags":["platform"],"security":[{"bearerAuth":[]}],"parameters":[{"name":"key","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"2XX":{"description":"Success envelope; `result` shape per endpoint (see the TypeScript SDK types).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}},"delete":{"operationId":"delete_settings_key","summary":"Unset a setting at a scope.","tags":["platform"],"security":[{"bearerAuth":[]}],"parameters":[{"name":"key","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"2XX":{"description":"Success envelope; `result` shape per endpoint (see the TypeScript SDK types).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/blog":{"get":{"operationId":"get_blog","summary":"Published blog posts (?locale=).","tags":["content"],"security":[],"responses":{"2XX":{"description":"Success envelope; `result` shape per endpoint (see the TypeScript SDK types).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}},"post":{"operationId":"post_blog","summary":"Create a blog post (draft).","tags":["content"],"security":[{"bearerAuth":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"2XX":{"description":"Success envelope; `result` shape per endpoint (see the TypeScript SDK types).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/blog/{slug}":{"get":{"operationId":"get_blog_slug","summary":"One post + JSON-LD.","tags":["content"],"security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"2XX":{"description":"Success envelope; `result` shape per endpoint (see the TypeScript SDK types).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/blog/{id}/publish":{"post":{"operationId":"post_blog_id_publish","summary":"Publish a draft post.","tags":["content"],"security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"2XX":{"description":"Success envelope; `result` shape per endpoint (see the TypeScript SDK types).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/billing/cancellation":{"post":{"operationId":"post_billing_cancellation","summary":"Cancel MeetMyAgent Business (Verträge hier kündigen). Works without a session; with one (account:manage) the account's own subscription ends with its period at once, or on the declared later day. Returns the reference number, the time of receipt and the declaration; mailSent says whether the confirmation went out.","tags":["billing"],"security":[{"bearerAuth":[]},{}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"2XX":{"description":"Success envelope; `result` shape per endpoint (see the TypeScript SDK types).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}},"get":{"operationId":"get_billing_cancellation","summary":"The account's own cancellations to a later day that are still waiting (reference, receipt, kind, requested end), so the account page can show them and offer to take them back. Session only.","tags":["billing"],"security":[{"bearerAuth":[]}],"responses":{"2XX":{"description":"Success envelope; `result` shape per endpoint (see the TypeScript SDK types).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/billing/cancellation/undo":{"post":{"operationId":"post_billing_cancellation_undo","summary":"Take a scheduled cancellation back before it takes effect, also one for a later day. Session only; answers the next renewal, or 409 when an end is still set.","tags":["billing"],"security":[{"bearerAuth":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"2XX":{"description":"Success envelope; `result` shape per endpoint (see the TypeScript SDK types).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/me/agent/card":{"get":{"operationId":"get_me_agent_card","summary":"My agent's public contact card: the card, its revision, what the page shows from it (preview) and what saving the contact still needs (contactMissing).","tags":["agents"],"security":[{"bearerAuth":[]}],"responses":{"2XX":{"description":"Success envelope; `result` shape per endpoint (see the TypeScript SDK types).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}},"patch":{"operationId":"patch_me_agent_card","summary":"Change the public contact card: body { revision, ...fields }; a field left out stays, null removes it. Refused with conflict when the card changed since that revision; the Google profile link needs Business (plan_limit_reached).","tags":["agents"],"security":[{"bearerAuth":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"2XX":{"description":"Success envelope; `result` shape per endpoint (see the TypeScript SDK types).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/hosted/{slug}/vcard":{"get":{"operationId":"get_hosted_slug_vcard","summary":"The contact card of a live hosted agent as a vCard 4.0 file (text/vcard, not the envelope); 404 while the agent is not live or its card has no name or contact way.","tags":["agents"],"security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"2XX":{"description":"Not the platform envelope, see the endpoint summary (OAuth RFC JSON, raw document, or text/plain)."},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/me/agent/qr":{"get":{"operationId":"get_me_agent_qr","summary":"My agent's QR codes, retired ones included: code, url (the address inside the QR, https://<site>/q/<code>), shortUrl, label, placement, greeting, questions, state.","tags":["agents"],"security":[{"bearerAuth":[]}],"responses":{"2XX":{"description":"Success envelope; `result` shape per endpoint (see the TypeScript SDK types).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}},"post":{"operationId":"post_me_agent_qr","summary":"A new QR code for my agent: body { label, placement: business_card|shop_window|flyer|stand|other, greeting?, questions? (up to 3) }. Every code opens the same agent page; the code is bound to the agent, not to its address. Send an Idempotency-Key so a double submit makes one code.","tags":["agents"],"security":[{"bearerAuth":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"2XX":{"description":"Success envelope; `result` shape per endpoint (see the TypeScript SDK types).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"description":"Supports the `Idempotency-Key` header: identical retries return the first result; a reused key with a different payload fails with `idempotency_key_reused`."}},"/v1/me/agent/qr/{id}":{"get":{"operationId":"get_me_agent_qr_id","summary":"One QR code of my agent.","tags":["agents"],"security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"2XX":{"description":"Success envelope; `result` shape per endpoint (see the TypeScript SDK types).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}},"patch":{"operationId":"patch_me_agent_qr_id","summary":"Change a QR code: label, placement, greeting (null removes it), questions, or state paused|active (pause and reactivate; the code stays the same). A retired code does not change (conflict).","tags":["agents"],"security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"2XX":{"description":"Success envelope; `result` shape per endpoint (see the TypeScript SDK types).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/me/agent/qr/{id}/retire":{"post":{"operationId":"post_me_agent_qr_id_retire","summary":"Retire a QR code for good: body { confirm: true }. Its address answers 410 from then on and the code is never handed out again.","tags":["agents"],"security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"2XX":{"description":"Success envelope; `result` shape per endpoint (see the TypeScript SDK types).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/me/agent/qr/{id}/file":{"get":{"operationId":"get_me_agent_qr_id_file","summary":"A file of a QR code (not the envelope): ?format=svg|png|pdf, png with &scale=4..40 pixels per module, pdf (the two-sided 85 x 55 mm business card) with &locale=de|en and &bleed=0..5 mm (default 3).","tags":["agents"],"security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"2XX":{"description":"Not the platform envelope, see the endpoint summary (OAuth RFC JSON, raw document, or text/plain)."},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/me/agent/qr/{id}/link":{"get":{"operationId":"get_me_agent_qr_id_link","summary":"A signed download address for one file of a QR code (the same options as /file) that works for 15 minutes; the printed QR address itself never expires.","tags":["agents"],"security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"2XX":{"description":"Success envelope; `result` shape per endpoint (see the TypeScript SDK types).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/me/agent/qr/{id}/stats":{"get":{"operationId":"get_me_agent_qr_id_stats","summary":"The day counters of a QR code (?days=1..366, default 30): views of the short address, chat starts, requests, vCard downloads and contact clicks. Counts of server events, not people, scans, saved contacts or sales.","tags":["agents"],"security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"2XX":{"description":"Success envelope; `result` shape per endpoint (see the TypeScript SDK types).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/qr/{code}":{"get":{"operationId":"get_qr_code","summary":"Where a QR address /q/<code> leads: { state: active, slug, pagePath } for an active code of a live agent, { state: retired } for a retired one; 404 for anything else. Read only.","tags":["agents"],"security":[],"parameters":[{"name":"code","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"2XX":{"description":"Success envelope; `result` shape per endpoint (see the TypeScript SDK types).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/qr/{code}/visits":{"post":{"operationId":"post_qr_code_visits","summary":"Resolves like GET /v1/qr/:code and counts one view. Meant for the site's /q resolver on a real visit; it leaves out HEAD, bots and link previews.","tags":["agents"],"security":[],"parameters":[{"name":"code","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"2XX":{"description":"Success envelope; `result` shape per endpoint (see the TypeScript SDK types).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/qr/files/{token}":{"get":{"operationId":"get_qr_files_token","summary":"The file behind a signed QR download link (not the envelope); 404 when the link is invalid or expired.","tags":["agents"],"security":[],"parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"2XX":{"description":"Not the platform envelope, see the endpoint summary (OAuth RFC JSON, raw document, or text/plain)."},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/hosted/{slug}/events":{"post":{"operationId":"post_hosted_slug_events","summary":"Counts one contact click for a QR code: body { type: contact_click, action, entry: <code> }. The action is one of call, email, whatsapp, website or maps. Nothing is stored about who clicked; always 202.","tags":["agents"],"security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"2XX":{"description":"Success envelope; `result` shape per endpoint (see the TypeScript SDK types).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/me/agent/card/images/{kind}":{"put":{"operationId":"put_me_agent_card_images_kind","summary":"Set an image of my agent's public card: kind logo, portrait or cover, the body is the image itself (Content-Type image/png, image/jpeg or image/webp, at most 5 MB; SVG, GIF and form uploads are refused). The server re-encodes it to WebP without metadata and cuts it to its kind (logo and portrait square up to 512 px, cover up to 1600 x 600); the card names it by its hash and its revision moves on by one. Answers with the card state.","tags":["agents"],"security":[{"bearerAuth":[]}],"parameters":[{"name":"kind","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"2XX":{"description":"Success envelope; `result` shape per endpoint (see the TypeScript SDK types).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}},"delete":{"operationId":"delete_me_agent_card_images_kind","summary":"Remove an image of my agent's public card (logo, portrait or cover); the card revision moves on by one, and no image there is no error. Answers with the card state.","tags":["agents"],"security":[{"bearerAuth":[]}],"parameters":[{"name":"kind","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"2XX":{"description":"Success envelope; `result` shape per endpoint (see the TypeScript SDK types).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}},"get":{"operationId":"get_me_agent_card_images_kind","summary":"The image of one kind (logo, portrait or cover) my own agent's card names now, for the console preview: also while the agent is a draft or paused, and a portrait the page hides (image/webp, not the envelope, never stored by a cache). 404 when the card names no image of that kind.","tags":["agents"],"security":[{"bearerAuth":[]}],"parameters":[{"name":"kind","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"2XX":{"description":"Not the platform envelope, see the endpoint summary (OAuth RFC JSON, raw document, or text/plain)."},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/hosted/{slug}/images/{kind}/{file}":{"get":{"operationId":"get_hosted_slug_images_kind_file","summary":"An image of the public card of a live hosted agent, at the address its card gives (<hash>.webp; image/webp, not the envelope, cacheable for one hour). 404 while the agent is not live, and for every image its card does not name now.","tags":["agents"],"security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}},{"name":"kind","in":"path","required":true,"schema":{"type":"string"}},{"name":"file","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"2XX":{"description":"Not the platform envelope, see the endpoint summary (OAuth RFC JSON, raw document, or text/plain)."},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/me/assistant":{"get":{"operationId":"get_me_assistant","summary":"The setup assistant of my account: { enabled, reason, plan, used, cap, remaining, resetsAt }. reason is off, no_model or plan and is present only when enabled is false. used, cap and remaining count this UTC month; resetsAt is the start of the next one. Session only.","tags":["agents"],"security":[{"bearerAuth":[]}],"responses":{"2XX":{"description":"Success envelope; `result` shape per endpoint (see the TypeScript SDK types).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/me/assistant/sessions":{"post":{"operationId":"post_me_assistant_sessions","summary":"Open a setup assistant session. Business only (plan_limit_reached otherwise); not_found while the assistant is switched off or has no model. Session only.","tags":["agents"],"security":[{"bearerAuth":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"2XX":{"description":"Success envelope; `result` shape per endpoint (see the TypeScript SDK types).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/me/assistant/sessions/{id}":{"get":{"operationId":"get_me_assistant_sessions_id","summary":"One setup assistant session with its history: { session, messages }. A session of another account is not_found. Session only.","tags":["agents"],"security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"2XX":{"description":"Success envelope; `result` shape per endpoint (see the TypeScript SDK types).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/me/assistant/sessions/{id}/messages":{"post":{"operationId":"post_me_assistant_sessions_id_messages","summary":"One turn with the setup assistant: body { message (1 to 4000 characters), locale: de|en }. It sets up my own agent with the rights of my own session and never switches it live. The result is { reply, toolSteps: [{ name }], used, cap, remaining, aborted }. With Accept: text/event-stream the turn streams as SSE events instead: text, tool_call, tool_result, done { used, cap, remaining, aborted }, and error { slug, message } if it fails mid-run. Business only; each turn counts one against the monthly cap (assistant_limit_reached when it is used up). Session only.","tags":["agents"],"security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"2XX":{"description":"Success envelope; `result` shape per endpoint (see the TypeScript SDK types).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/me/agent/directories":{"get":{"operationId":"get_me_agent_directories","summary":"The external agent directories for my agent: per directory whether it is switched on on this server (verfuegbar; abgeschaltet schalter_aus or schluessel_fehlt), its capabilities (faehigkeiten), the approval revision it needs, the state (zustand), the last error and notes (hinweise); plus the blocked directories with their reason and manual recommendations, which are never synchronized. Never a token.","tags":["agents"],"security":[{"bearerAuth":[]}],"responses":{"2XX":{"description":"Success envelope; `result` shape per endpoint (see the TypeScript SDK types).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/me/agent/directories/{ziel}/preview":{"get":{"operationId":"get_me_agent_directories_ziel_preview","summary":"What would be sent to one directory, built from the public view of my live agent: the fields sent, the fields not sent with the reason, the export revision and the approval revision. No directory is contacted.","tags":["agents"],"security":[{"bearerAuth":[]}],"parameters":[{"name":"ziel","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"2XX":{"description":"Success envelope; `result` shape per endpoint (see the TypeScript SDK types).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/me/agent/directories/{ziel}/activate":{"post":{"operationId":"post_me_agent_directories_ziel_activate","summary":"Opt in to one directory: body { freigabeRevision } naming the revision the preview showed (conflict once it moved on). Records the approval for this directory only; nothing is sent yet. not_found while the directory is switched off on this server.","tags":["agents"],"security":[{"bearerAuth":[]}],"parameters":[{"name":"ziel","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"2XX":{"description":"Success envelope; `result` shape per endpoint (see the TypeScript SDK types).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/me/agent/directories/{ziel}/publish":{"post":{"operationId":"post_me_agent_directories_ziel_publish","summary":"Publish my live agent to one approved directory now, or bring the entry up to date. The entry counts as published only after reading it back matched what was sent. Returns { ergebnis, status }; not_found while the directory is switched off.","tags":["agents"],"security":[{"bearerAuth":[]}],"parameters":[{"name":"ziel","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"2XX":{"description":"Success envelope; `result` shape per endpoint (see the TypeScript SDK types).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/me/agent/directories/{ziel}/update":{"post":{"operationId":"post_me_agent_directories_ziel_update","summary":"Bring an existing entry in one directory up to date now and read it back. Returns { ergebnis, status }.","tags":["agents"],"security":[{"bearerAuth":[]}],"parameters":[{"name":"ziel","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"2XX":{"description":"Success envelope; `result` shape per endpoint (see the TypeScript SDK types).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/me/agent/directories/{ziel}/revoke":{"post":{"operationId":"post_me_agent_directories_ziel_revoke","summary":"Withdraw the approval for one directory: nothing is published or updated there any more. A directory without a temporary pause (ALLAGENTS) keeps the entry and the state says so; nothing is removed.","tags":["agents"],"security":[{"bearerAuth":[]}],"parameters":[{"name":"ziel","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"2XX":{"description":"Success envelope; `result` shape per endpoint (see the TypeScript SDK types).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/me/agent/directories/{ziel}/remove":{"post":{"operationId":"post_me_agent_directories_ziel_remove","summary":"Remove the entry from one directory. Where the removal is permanent (ALLAGENTS), body { bestaetigung: dauerhaft } is required (invalid_request otherwise). It counts as removed only once the directory no longer shows it.","tags":["agents"],"security":[{"bearerAuth":[]}],"parameters":[{"name":"ziel","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"2XX":{"description":"Success envelope; `result` shape per endpoint (see the TypeScript SDK types).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"default":{"description":"Failure envelope with stable error codes (see /v1 index → errors documentation).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Session token, scoped API key, or OAuth access token. Required scopes are listed per endpoint in GET /v1."}},"schemas":{"Envelope":{"type":"object","required":["success","result","errors","messages","request_id"],"properties":{"success":{"type":"boolean","const":true},"result":{"description":"Endpoint-specific result."},"errors":{"type":"array","maxItems":0,"items":{"$ref":"#/components/schemas/EnvelopeError"}},"messages":{"type":"array","items":{"type":"string"}},"result_info":{"type":"object","description":"Present on paginated lists.","properties":{"cursor":{"type":["string","null"],"description":"Opaque cursor for the next page; null when exhausted."},"count":{"type":"integer"},"per_page":{"type":"integer"}}},"links":{"type":"array","description":"Next-action links on a single-resource response, chain by following `rel`, never by rebuilding the URL.","items":{"type":"object","required":["rel","href","method"],"properties":{"rel":{"type":"string","description":"Stable relation name (self, plus the actions the resource offers)."},"href":{"type":"string","format":"uri"},"method":{"type":"string","enum":["GET","POST","PATCH","DELETE"]},"title":{"type":"string"}}}},"request_id":{"type":"string","description":"Echoes X-Request-Id; quote it in support requests."}}},"ErrorEnvelope":{"type":"object","required":["success","result","errors","messages","request_id"],"properties":{"success":{"type":"boolean","const":false},"result":{"type":"null"},"errors":{"type":"array","minItems":1,"items":{"$ref":"#/components/schemas/EnvelopeError"}},"messages":{"type":"array","items":{"type":"string"}},"request_id":{"type":"string"}}},"EnvelopeError":{"type":"object","required":["code","slug","message","documentation_url"],"properties":{"code":{"type":"integer","description":"Stable numeric code (never reused)."},"slug":{"type":"string","enum":["auth_required","invalid_token","insufficient_scope","principal_not_verified","invalid_credentials","email_taken","magic_link_invalid","magic_link_throttled","password_too_weak","api_key_not_found","scope_not_grantable","oauth_invalid_client","oauth_invalid_grant","oauth_invalid_request","oauth_redirect_mismatch","oauth_request_not_found","social_provider_unavailable","social_email_unverified","invalid_request","not_found","idempotency_key_reused","conflict","rate_limited","agent_not_found","principal_not_found","setting_not_found","setting_invalid_value","setting_scope_not_allowed","blog_post_not_found","blog_slug_conflict","token_consumed","confirmation_token_invalid","confirmation_token_expired","confirmation_text_changed","hosted_agent_not_found","agent_slug_taken","agent_slug_invalid","agent_not_ready","agent_content_rejected","knowledge_limit_reached","knowledge_source_not_found","knowledge_fetch_failed","knowledge_login_wall","agent_request_not_found","agent_slug_locked","external_agent_not_found","agent_card_unreachable","agent_card_invalid","agent_card_signature_invalid","agent_domain_not_verified","external_agent_forbidden","directory_entry_not_found","remote_agent_failed","billing_not_configured","already_subscribed","billing_customer_missing","billing_confirmation_required","plan_limit_reached","assistant_limit_reached","internal","not_implemented"],"description":"Stable string code, branch on this."},"message":{"type":"string"},"documentation_url":{"type":"string","format":"uri"}}}}}}