{"components":{"responses":{},"schemas":{"Backlink":{"allOf":[{"$ref":"#/components/schemas/NoteSummary"},{"properties":{"context":{"type":"string"}},"required":["context"],"type":"object"}],"title":"Backlink"},"DeletedDocument":{"properties":{"deleted":{"type":"boolean"},"path":{"type":"string"},"vault_id":{"type":"string"}},"required":["vault_id","path","deleted"],"title":"DeletedDocument","type":"object"},"DeletedEmbeddingConfiguration":{"properties":{"deleted":{"type":"boolean"},"user_id":{"type":"string"}},"required":["user_id","deleted"],"title":"DeletedEmbeddingConfiguration","type":"object"},"DeletedNote":{"properties":{"deleted":{"type":"boolean"},"id":{"type":"string"},"vault_id":{"type":"string"}},"required":["vault_id","id","deleted"],"title":"DeletedNote","type":"object"},"Document":{"properties":{"id":{"nullable":true,"type":"string"},"kind":{"enum":["note","asset"],"type":"string"},"media_type":{"type":"string"},"path":{"type":"string"},"size":{"nullable":true,"type":"integer"},"updated_at":{"nullable":true,"type":"string"},"vault_id":{"type":"string"}},"required":["path","kind","media_type"],"title":"Document","type":"object"},"DocumentContent":{"allOf":[{"$ref":"#/components/schemas/Document"},{"properties":{"data_base64":{"format":"byte","type":"string"}},"required":["data_base64"],"type":"object"}],"title":"DocumentContent"},"EmbeddingConfiguration":{"properties":{"created_at":{"type":"string"},"credential_hint":{"type":"string"},"dimensions":{"nullable":true,"type":"integer"},"endpoint":{"type":"string"},"model":{"type":"string"},"updated_at":{"type":"string"},"user_id":{"type":"string"},"validated_at":{"nullable":true,"type":"string"}},"required":["user_id","endpoint","model","credential_hint","created_at","updated_at"],"title":"EmbeddingConfiguration","type":"object"},"EmbeddingConfigurationInput":{"additionalProperties":false,"properties":{"dimensions":{"maximum":10000,"minimum":1,"type":"integer"},"endpoint":{"description":"An endpoint speaking the OpenAI embeddings protocol. Must use https and must not resolve to a private or loopback address.","example":"https://api.openai.com/v1/embeddings","type":"string"},"model":{"example":"text-embedding-3-small","type":"string"},"token":{"format":"password","type":"string","writeOnly":true}},"title":"EmbeddingConfigurationInput","type":"object"},"EmbeddingInput":{"additionalProperties":false,"properties":{"input":{"type":"string"},"token":{"format":"password","type":"string","writeOnly":true}},"required":["input"],"title":"EmbeddingInput","type":"object"},"EmbeddingResult":{"properties":{"dimensions":{"type":"integer"},"embedding":{"items":{"type":"number"},"type":"array"},"endpoint":{"type":"string"},"model":{"type":"string"},"usage":{"additionalProperties":true,"type":"object"},"user_id":{"type":"string"},"vault_id":{"type":"string"}},"required":["vault_id","user_id","endpoint","model","embedding","dimensions","usage"],"title":"EmbeddingResult","type":"object"},"EmbeddingValidation":{"properties":{"dimensions":{"type":"integer"},"endpoint":{"type":"string"},"model":{"type":"string"},"status":{"type":"string"},"user_id":{"type":"string"}},"required":["status","user_id","endpoint","model","dimensions"],"title":"EmbeddingValidation","type":"object"},"EmbeddingValidationInput":{"additionalProperties":false,"properties":{"token":{"format":"password","type":"string","writeOnly":true}},"title":"EmbeddingValidationInput","type":"object"},"Graph":{"properties":{"depth":{"type":"integer"},"edges":{"items":{"type":"object"},"type":"array"},"nodes":{"items":{"type":"object"},"type":"array"},"root_id":{"type":"string"},"vault_id":{"type":"string"}},"required":["vault_id","root_id","depth","nodes","edges"],"title":"Graph","type":"object"},"ImportInput":{"additionalProperties":false,"properties":{"body":{"type":"string"},"filename":{"type":"string"}},"required":["filename","body"],"title":"ImportInput","type":"object"},"Note":{"allOf":[{"$ref":"#/components/schemas/NoteSummary"},{"properties":{"body":{"type":"string"},"links":{"items":{"type":"object"},"type":"array"},"tags":{"items":{"type":"string"},"type":"array"}},"required":["body","tags","links"],"type":"object"}],"title":"Note"},"NoteInput":{"additionalProperties":false,"properties":{"body":{"type":"string"},"id":{"type":"string"},"metadata":{"additionalProperties":true,"type":"object"},"path":{"type":"string"},"title":{"type":"string"}},"required":["body"],"title":"NoteInput","type":"object"},"NoteList":{"properties":{"data":{"items":{"$ref":"#/components/schemas/NoteSummary"},"type":"array"},"pagination":{"properties":{"limit":{"type":"integer"},"offset":{"type":"integer"},"total":{"type":"integer"}},"required":["limit","offset","total"],"type":"object"}},"required":["data","pagination"],"title":"NoteList","type":"object"},"NoteSummary":{"properties":{"created_at":{"type":"string"},"id":{"type":"string"},"metadata":{"additionalProperties":true,"type":"object"},"path":{"type":"string"},"title":{"type":"string"},"updated_at":{"type":"string"},"vault_id":{"type":"string"}},"required":["vault_id","id","title","path","metadata","created_at","updated_at"],"title":"NoteSummary","type":"object"},"SearchResult":{"allOf":[{"$ref":"#/components/schemas/NoteSummary"},{"properties":{"rank":{"type":"number"},"snippet":{"type":"string"}},"required":["snippet","rank"],"type":"object"}],"title":"SearchResult"},"Status":{"properties":{"status":{"type":"string"}},"required":["status"],"title":"Status","type":"object"},"User":{"properties":{"created_at":{"type":"string"},"email":{"format":"email","type":"string"},"email_verified_at":{"nullable":true,"type":"string"},"id":{"type":"string"},"name":{"nullable":true,"type":"string"},"updated_at":{"type":"string"}},"required":["id","email","email_verified_at","created_at","updated_at"],"title":"User","type":"object"},"UserInput":{"additionalProperties":false,"properties":{"email":{"format":"email","type":"string"},"id":{"type":"string"},"name":{"type":"string"}},"required":["email"],"title":"UserInput","type":"object"},"Vault":{"properties":{"created_at":{"type":"string"},"id":{"type":"string"},"name":{"type":"string"},"storage_prefix":{"type":"string"},"updated_at":{"type":"string"},"user_id":{"type":"string"}},"required":["id","user_id","name","storage_prefix","created_at","updated_at"],"title":"Vault","type":"object"},"VaultInput":{"additionalProperties":false,"properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["name"],"title":"VaultInput","type":"object"}},"securitySchemes":{"bearerAuth":{"scheme":"bearer","type":"http"}}},"info":{"description":"Manage users, isolated Markdown vaults, notes, and bring-your-own embedding credentials through a headless service.","title":"Markdow note interface","version":"0.1.0"},"openapi":"3.0.0","paths":{"/vaults/{vault_id}/search":{"get":{"callbacks":{},"operationId":"search_notes","parameters":[{"description":"","in":"path","name":"vault_id","required":true,"schema":{"type":"string"}},{"description":"","in":"query","name":"q","required":true,"schema":{"type":"string"}},{"description":"","in":"query","name":"limit","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/SearchResult"},"type":"array"}}},"description":"Search results"}},"security":[{"bearerAuth":[]}],"summary":"Search notes","tags":["Notes"]}},"/openapi.json":{"get":{"callbacks":{},"operationId":"get_openapi_document","parameters":[],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"OpenAPI document"}},"security":[],"summary":"Read the machine-readable application programming interface description","tags":["Documentation"]}},"/oauth2/authorize/deny":{"post":{"callbacks":{},"operationId":"deny_oauth_client","parameters":[],"requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Authorization denial","required":false},"responses":{"302":{"content":{"text/html":{"schema":{"type":"string"}}},"description":"Authorization denial"}},"security":[],"summary":"Deny an OAuth client authorization request","tags":["Authentication"]}},"/users/{user_id}/vaults":{"get":{"callbacks":{},"operationId":"list_vaults","parameters":[{"description":"","in":"path","name":"user_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/Vault"},"type":"array"}}},"description":"Vaults"}},"security":[{"bearerAuth":[]}],"summary":"List a user's vaults","tags":["Vaults"]},"post":{"callbacks":{},"operationId":"create_vault","parameters":[{"description":"","in":"path","name":"user_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VaultInput"}}},"description":"Vault","required":false},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Vault"}}},"description":"Created vault"}},"security":[{"bearerAuth":[]}],"summary":"Create a vault","tags":["Vaults"]}},"/.well-known/oauth-authorization-server":{"get":{"callbacks":{},"operationId":"get_oauth_authorization_server","parameters":[],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"Authorization server metadata"}},"security":[],"summary":"Discover OAuth authorization endpoints","tags":["Agent authentication"]}},"/users/{user_id}/oauth-clients":{"get":{"callbacks":{},"operationId":"list_oauth_clients","parameters":[{"description":"","in":"path","name":"user_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"type":"object"},"type":"array"}}},"description":"Clients"}},"security":[{"bearerAuth":[]}],"summary":"List the OAuth clients registered for an account","tags":["Agent authentication"]}},"/vaults/{vault_id}/documents":{"get":{"callbacks":{},"operationId":"list_documents","parameters":[{"description":"","in":"path","name":"vault_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/Document"},"type":"array"}}},"description":"Documents"}},"security":[{"bearerAuth":[]}],"summary":"List vault documents","tags":["Documents"]}},"/oauth2/token":{"post":{"callbacks":{},"operationId":"exchange_agent_credential","parameters":[],"requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Token grant","required":false},"responses":{"200":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"Access token"}},"security":[],"summary":"Poll a claim or exchange a service identity assertion","tags":["Agent authentication"]}},"/users/{user_id}/agent-credentials":{"delete":{"callbacks":{},"operationId":"revoke_agent_credentials","parameters":[{"description":"","in":"path","name":"user_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"revoked":{"type":"integer"},"user_id":{"type":"string"}},"required":["user_id","revoked"],"type":"object"}}},"description":"Revocation result"}},"security":[{"bearerAuth":[]}],"summary":"Revoke every agent credential for a user","tags":["Users"]}},"/vaults/{vault_id}/notes/{id}/graph":{"get":{"callbacks":{},"operationId":"get_note_graph","parameters":[{"description":"","in":"path","name":"vault_id","required":true,"schema":{"type":"string"}},{"description":"","in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"","in":"query","name":"depth","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Graph"}}},"description":"Linked-note graph"}},"security":[{"bearerAuth":[]}],"summary":"Get a linked-note graph","tags":["Notes"]}},"/agent/identity/claim/sign-out":{"post":{"callbacks":{},"operationId":"sign_out_agent_claim_user","parameters":[],"requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"properties":{"claim_attempt_token":{"type":"string"}},"required":["claim_attempt_token"],"type":"object"}}},"description":"Claim","required":false},"responses":{"302":{"content":{"text/html":{"schema":{"type":"string"}}},"description":"Signed out"}},"security":[],"summary":"End the claim browser session","tags":["Agent authentication"]}},"/agent/identity/claim/confirm":{"post":{"callbacks":{},"operationId":"confirm_agent_claim","parameters":[],"requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"properties":{"claim_attempt_token":{"type":"string"}},"required":["claim_attempt_token"],"type":"object"}}},"description":"Confirmation","required":false},"responses":{"200":{"content":{"text/html":{"schema":{"type":"string"}}},"description":"Claim confirmed"}},"security":[],"summary":"Confirm an agent claim as the authenticated email owner","tags":["Agent authentication"]}},"/oauth2/authorize":{"get":{"callbacks":{},"operationId":"authorize_oauth_client","parameters":[{"description":"","in":"query","name":"client_id","required":true,"schema":{"type":"string"}}],"responses":{"302":{"content":{"text/html":{"schema":{"type":"string"}}},"description":"Authorization result"}},"security":[],"summary":"Authorize a client for the signed-in user","tags":["Authentication"]},"post":{"callbacks":{},"operationId":"approve_oauth_client","parameters":[],"requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Authorization approval","required":false},"responses":{"302":{"content":{"text/html":{"schema":{"type":"string"}}},"description":"Authorization result"}},"security":[],"summary":"Approve an OAuth client authorization request","tags":["Authentication"]}},"/oauth2/revoke":{"post":{"callbacks":{},"operationId":"revoke_agent_credential","parameters":[],"requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"properties":{"token":{"type":"string"},"token_type_hint":{"type":"string"}},"type":"object"}}},"description":"Revocation request","required":false},"responses":{"200":{"content":{"text/plain":{"schema":{"type":"string"}}},"description":"Credential revoked"}},"security":[],"summary":"Revoke one agent access token","tags":["Agent authentication"]}},"/accounts/log-in/{token}":{"get":{"callbacks":{},"operationId":"consume_email_login","parameters":[{"description":"","in":"path","name":"token","required":true,"schema":{"type":"string"}}],"responses":{"302":{"content":{"text/html":{"schema":{"type":"string"}}},"description":"Signed in"}},"security":[],"summary":"Consume a one-time email sign-in link","tags":["Authentication"]}},"/auth.md":{"get":{"callbacks":{},"operationId":"oauth_instructions","parameters":[],"responses":{"200":{"content":{"text/markdown":{"schema":{"type":"string"}}},"description":"auth.md"}},"security":[],"summary":"Read OAuth authorization instructions","tags":["Authentication"]}},"/.well-known/oauth-protected-resource":{"get":{"callbacks":{},"operationId":"get_oauth_protected_resource","parameters":[],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"Protected resource metadata"}},"security":[],"summary":"Discover authorization for the note interface","tags":["Agent authentication"]}},"/agent/identity/claim/resend-email-link":{"post":{"callbacks":{},"operationId":"resend_agent_claim_email_link","parameters":[],"requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"properties":{"claim_attempt_token":{"type":"string"}},"required":["claim_attempt_token"],"type":"object"}}},"description":"Claim","required":false},"responses":{"200":{"content":{"text/html":{"schema":{"type":"string"}}},"description":"Email sent"},"403":{"content":{"text/html":{"schema":{"type":"string"}}},"description":"Sign-ups are disabled"}},"security":[],"summary":"Send another one-time email link for an agent claim","tags":["Agent authentication"]}},"/vaults/{vault_id}/notes/{id}":{"delete":{"callbacks":{},"operationId":"delete_note","parameters":[{"description":"","in":"path","name":"vault_id","required":true,"schema":{"type":"string"}},{"description":"","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeletedNote"}}},"description":"Deleted note"}},"security":[{"bearerAuth":[]}],"summary":"Delete a note","tags":["Notes"]},"get":{"callbacks":{},"operationId":"get_note","parameters":[{"description":"","in":"path","name":"vault_id","required":true,"schema":{"type":"string"}},{"description":"","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Note"}}},"description":"Note"}},"security":[{"bearerAuth":[]}],"summary":"Get a note","tags":["Notes"]},"put":{"callbacks":{},"operationId":"update_note","parameters":[{"description":"","in":"path","name":"vault_id","required":true,"schema":{"type":"string"}},{"description":"","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NoteInput"}}},"description":"Note","required":false},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Note"}}},"description":"Updated note"}},"security":[{"bearerAuth":[]}],"summary":"Update a note","tags":["Notes"]}},"/.well-known/jwks.json":{"get":{"callbacks":{},"operationId":"get_agent_auth_signing_keys","parameters":[],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"Public signing keys"}},"security":[],"summary":"Read public keys for legacy service identity assertions","tags":["Agent authentication"]}},"/privacy":{"get":{"callbacks":{},"operationId":"privacy_policy","parameters":[],"responses":{"200":{"content":{"text/html":{"schema":{"type":"string"}}},"description":"Privacy policy"}},"security":[],"summary":"Read the privacy policy","tags":["Website"]}},"/agent/identity/claim":{"get":{"callbacks":{},"operationId":"show_agent_claim","parameters":[{"description":"","in":"query","name":"claim_attempt_token","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"text/html":{"schema":{"type":"string"}}},"description":"Claim page"}},"security":[],"summary":"Sign in by email to confirm an agent claim","tags":["Agent authentication"]},"post":{"callbacks":{},"operationId":"start_agent_claim","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Claim request","required":false},"responses":{"400":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"Flow is disabled"}},"security":[],"summary":"Start an anonymous claim when that optional flow is enabled","tags":["Agent authentication"]}},"/cookies":{"get":{"callbacks":{},"operationId":"cookie_terms","parameters":[],"responses":{"200":{"content":{"text/html":{"schema":{"type":"string"}}},"description":"Cookie terms"}},"security":[],"summary":"Read the cookie terms","tags":["Website"]}},"/health":{"get":{"callbacks":{},"operationId":"health","parameters":[],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Status"}}},"description":"Service is ready"}},"security":[],"summary":"Check service health","tags":["Service"]}},"/terms":{"get":{"callbacks":{},"operationId":"terms_of_service","parameters":[],"responses":{"200":{"content":{"text/html":{"schema":{"type":"string"}}},"description":"Terms of service"}},"security":[],"summary":"Read the terms of service","tags":["Website"]}},"/agent/identity":{"post":{"callbacks":{},"operationId":"register_agent_identity","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"properties":{"login_hint":{"format":"email","type":"string"},"type":{"enum":["service_auth"],"type":"string"}},"required":["type","login_hint"],"type":"object"}}},"description":"Agent registration","required":false},"responses":{"200":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"Registration ceremony"}},"security":[],"summary":"Start an auth.md agent registration","tags":["Agent authentication"]}},"/vaults/{vault_id}/notes/import":{"post":{"callbacks":{},"operationId":"import_note","parameters":[{"description":"","in":"path","name":"vault_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ImportInput"}}},"description":"Markdown file contents","required":false},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Note"}}},"description":"Imported note"}},"security":[{"bearerAuth":[]}],"summary":"Import a Markdown file","tags":["Index"]}},"/users":{"get":{"callbacks":{},"operationId":"list_users","parameters":[],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/User"},"type":"array"}}},"description":"Users"}},"security":[{"bearerAuth":[]}],"summary":"List users","tags":["Users"]},"post":{"callbacks":{},"operationId":"create_user","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserInput"}}},"description":"User","required":false},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/User"}}},"description":"Created user"},"403":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"Sign-ups are disabled"}},"security":[{"bearerAuth":[]}],"summary":"Create a user","tags":["Users"]}},"/.well-known/mcp/server-card.json":{"get":{"callbacks":{},"operationId":"get_mcp_server_card","parameters":[],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"Server card"}},"security":[],"summary":"Discover the Markdow Model Context Protocol server","tags":["Agent authentication"]}},"/oauth2/register":{"post":{"callbacks":{},"operationId":"register_oauth_client","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"properties":{"client_name":{"type":"string"},"grant_types":{"items":{"type":"string"},"type":"array"},"redirect_uris":{"items":{"type":"string"},"type":"array"},"response_types":{"items":{"type":"string"},"type":"array"},"token_endpoint_auth_method":{"type":"string"}},"required":["redirect_uris"],"type":"object"}}},"description":"Client metadata","required":false},"responses":{"201":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"Registered client"}},"security":[],"summary":"Register a public OAuth client","tags":["Authentication"]}},"/":{"get":{"callbacks":{},"operationId":"home","parameters":[],"responses":{"200":{"content":{"text/html":{"schema":{"type":"string"}}},"description":"Editorial product introduction"}},"security":[],"summary":"Understand what Markdow is","tags":["Website"]}},"/accounts/log-in":{"get":{"callbacks":{},"operationId":"show_email_login","parameters":[{"description":"","in":"query","name":"email","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"text/html":{"schema":{"type":"string"}}},"description":"Sign-in page"}},"security":[],"summary":"Show the email-link sign-in page","tags":["Authentication"]},"post":{"callbacks":{},"operationId":"request_email_login","parameters":[],"requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"properties":{"email":{"format":"email","type":"string"}},"required":["email"],"type":"object"}}},"description":"Email address","required":false},"responses":{"200":{"content":{"text/html":{"schema":{"type":"string"}}},"description":"Email sent"},"403":{"content":{"text/html":{"schema":{"type":"string"}}},"description":"Sign-ups are disabled"}},"security":[],"summary":"Send a one-time email sign-in link","tags":["Authentication"]}},"/vaults/{id}":{"get":{"callbacks":{},"operationId":"get_vault","parameters":[{"description":"","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Vault"}}},"description":"Vault"}},"security":[{"bearerAuth":[]}],"summary":"Get a vault","tags":["Vaults"]}},"/users/{user_id}/embedding-configuration":{"delete":{"callbacks":{},"operationId":"delete_embedding_configuration","parameters":[{"description":"","in":"path","name":"user_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeletedEmbeddingConfiguration"}}},"description":"Deleted embedding configuration"}},"security":[{"bearerAuth":[]}],"summary":"Delete an embedding configuration","tags":["Embeddings"]},"get":{"callbacks":{},"operationId":"get_embedding_configuration","parameters":[{"description":"","in":"path","name":"user_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmbeddingConfiguration"}}},"description":"Embedding configuration"}},"security":[{"bearerAuth":[]}],"summary":"Get a redacted embedding configuration","tags":["Embeddings"]},"put":{"callbacks":{},"operationId":"configure_embedding","parameters":[{"description":"","in":"path","name":"user_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmbeddingConfigurationInput"}}},"description":"Embedding configuration","required":false},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmbeddingConfiguration"}}},"description":"Embedding configuration"}},"security":[{"bearerAuth":[]}],"summary":"Configure embeddings with an account-supplied endpoint and credential","tags":["Embeddings"]}},"/users/{user_id}/embedding-configuration/validate":{"post":{"callbacks":{},"operationId":"validate_embedding_configuration","parameters":[{"description":"","in":"path","name":"user_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmbeddingValidationInput"}}},"description":"Optional temporary credential","required":false},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmbeddingValidation"}}},"description":"Validation result"}},"security":[{"bearerAuth":[]}],"summary":"Validate an embedding configuration","tags":["Embeddings"]}},"/users/{id}":{"get":{"callbacks":{},"operationId":"get_user","parameters":[{"description":"","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/User"}}},"description":"User"}},"security":[{"bearerAuth":[]}],"summary":"Get a user","tags":["Users"]}},"/vaults/{vault_id}/documents/*path":{"delete":{"callbacks":{},"operationId":"delete_document","parameters":[{"description":"","in":"path","name":"vault_id","required":true,"schema":{"type":"string"}},{"description":"","in":"path","name":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeletedDocument"}}},"description":"Deleted document"}},"security":[{"bearerAuth":[]}],"summary":"Delete a vault document","tags":["Documents"]},"get":{"callbacks":{},"operationId":"read_document","parameters":[{"description":"","in":"path","name":"vault_id","required":true,"schema":{"type":"string"}},{"description":"","in":"path","name":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DocumentContent"}}},"description":"Document content"}},"security":[{"bearerAuth":[]}],"summary":"Read a vault document without changing its bytes","tags":["Documents"]},"put":{"callbacks":{},"operationId":"write_document","parameters":[{"description":"","in":"path","name":"vault_id","required":true,"schema":{"type":"string"}},{"description":"","in":"path","name":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"data_base64":{"format":"byte","type":"string"}},"required":["data_base64"],"type":"object"}}},"description":"Document content","required":false},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Document"}}},"description":"Stored document"}},"security":[{"bearerAuth":[]}],"summary":"Create or replace a vault document","tags":["Documents"]}},"/.well-known/oauth-protected-resource/mcp":{"get":{"callbacks":{},"operationId":"get_mcp_protected_resource","parameters":[],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"Protected resource metadata"}},"security":[],"summary":"Discover authorization for the Model Context Protocol server","tags":["Agent authentication"]}},"/docs":{"get":{"callbacks":{},"operationId":"api_reference","parameters":[],"responses":{"200":{"content":{"text/html":{"schema":{"type":"string"}}},"description":"Interactive reference"}},"security":[],"summary":"Browse the interactive application programming interface reference","tags":["Documentation"]}},"/og-image":{"get":{"callbacks":{},"operationId":"open_graph_image","parameters":[{"description":"Marketing page name","in":"query","name":"page","required":true,"schema":{"type":"string"}},{"description":"Card version","in":"query","name":"v","required":true,"schema":{"type":"string"}},{"description":"URL signature","in":"query","name":"sig","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"image/jpeg":{"schema":{"format":"binary","type":"string"}}},"description":"Rendered social card"}},"security":[],"summary":"Fetch the social preview image for a marketing page","tags":["Website"]}},"/vaults/{vault_id}/embeddings":{"post":{"callbacks":{},"operationId":"embed_text","parameters":[{"description":"","in":"path","name":"vault_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmbeddingInput"}}},"description":"Text to embed","required":false},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmbeddingResult"}}},"description":"Embedding"}},"security":[{"bearerAuth":[]}],"summary":"Create an embedding with a user-supplied credential","tags":["Embeddings"]}},"/agent/event/notify":{"post":{"callbacks":{},"operationId":"receive_agent_security_event","parameters":[],"requestBody":{"content":{"application/secevent+jwt":{"schema":{"type":"string"}}},"description":"Security event","required":false},"responses":{"400":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"Events are not enabled"}},"security":[],"summary":"Receive a provider security event when that optional flow is enabled","tags":["Agent authentication"]}},"/vaults/{vault_id}/index/rebuild":{"post":{"callbacks":{},"operationId":"rebuild_index","parameters":[{"description":"","in":"path","name":"vault_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Status"}}},"description":"Rebuilt"}},"security":[{"bearerAuth":[]}],"summary":"Rebuild the index","tags":["Index"]}},"/users/{user_id}/oauth-clients/{id}":{"delete":{"callbacks":{},"operationId":"delete_oauth_client","parameters":[{"description":"","in":"path","name":"user_id","required":true,"schema":{"type":"string"}},{"description":"","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"Deleted client"}},"security":[{"bearerAuth":[]}],"summary":"Delete an OAuth client and revoke its tokens","tags":["Agent authentication"]}},"/vaults/{vault_id}/notes/{id}/backlinks":{"get":{"callbacks":{},"operationId":"list_backlinks","parameters":[{"description":"","in":"path","name":"vault_id","required":true,"schema":{"type":"string"}},{"description":"","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/Backlink"},"type":"array"}}},"description":"Backlinks"}},"security":[{"bearerAuth":[]}],"summary":"List backlinks","tags":["Notes"]}},"/vaults/{vault_id}/notes":{"get":{"callbacks":{},"operationId":"list_notes","parameters":[{"description":"","in":"path","name":"vault_id","required":true,"schema":{"type":"string"}},{"description":"","in":"query","name":"limit","required":false,"schema":{"type":"integer"}},{"description":"","in":"query","name":"offset","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NoteList"}}},"description":"Paginated notes"}},"security":[{"bearerAuth":[]}],"summary":"List notes","tags":["Notes"]},"post":{"callbacks":{},"operationId":"create_note","parameters":[{"description":"","in":"path","name":"vault_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NoteInput"}}},"description":"Note","required":false},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Note"}}},"description":"Created note"}},"security":[{"bearerAuth":[]}],"summary":"Create a note","tags":["Notes"]}}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://markdow.org","variables":{}}],"tags":[]}