docbin

{'type': 'object', 'properties': {'name': {'type': 'string', 'description': 'Document name. A random slug is generated if omitted.'}, 'files': {'type': 'array', 'items': {'type': 'object', 'required': ['name', 'content'], 'properties': {'name': {'type': 'string'}, 'content': {'type': 'string'}, 'language': {'type': 'string'}}}, 'description': 'Optional: a multi-file group. When provided, supersedes content/content_type. The entry file is auto-selected (index/readme/main, else first). CROSS-FILE LINKS: to link from one file in the group to another, use a bare relative link to the sibling\'s filename, exactly as given in this `files` array - e.g. <a href="page2.html">. The viewer intercepts it and switches the active file (updating the left-pane selection and the URL). Do NOT use absolute URLs, slugs, ./ prefixes, or #file- hashes for cross-file links. In-page anchor links within a file (e.g. #section) work as normal.'}, 'content': {'type': 'string', 'description': 'The HTML, Markdown, MDX, or code body of the document.'}, 'language': {'type': 'string', 'description': "Syntax-highlight language hint, used when content_type is 'code' (e.g. 'rust')."}, 'visibility': {'enum': ['private', 'unlisted', 'public'], 'type': 'string', 'description': 'Defaults to public. private = owner only; unlisted = anyone with the link; public = listed, searchable, and crawlable.'}, 'content_type': {'enum': ['html', 'md', 'mdx', 'code'], 'type': 'string', 'description': "Defaults to html. 'mdx' renders Markdown with JSX components; 'code' renders a single syntax-highlighted block."}}}

{'type': 'object', 'required': ['handle', 'name', 'version', 'appUrl', 'rawUrl'], 'properties': {'name': {'type': 'string'}, 'appUrl': {'type': 'string'}, 'handle': {'type': 'string'}, 'rawUrl': {'type': 'string'}, 'deleted': {'type': 'boolean'}, 'snippet': {'type': 'string'}, 'version': {'type': 'number'}, 'language': {'type': ['string', 'null']}, 'visibility': {'type': 'string'}, 'contentType': {'type': 'string'}}}

{'type': 'object', 'required': ['name'], 'properties': {'name': {'type': 'string', 'description': 'Document name.'}, 'handle': {'type': 'string', 'description': 'Owner handle. Defaults to the authenticated user.'}, 'version': {'type': 'number', 'description': 'Version number. Defaults to the latest.'}}}

{'type': 'object', 'required': ['handle', 'name', 'version', 'appUrl', 'rawUrl'], 'properties': {'name': {'type': 'string'}, 'appUrl': {'type': 'string'}, 'handle': {'type': 'string'}, 'rawUrl': {'type': 'string'}, 'deleted': {'type': 'boolean'}, 'snippet': {'type': 'string'}, 'version': {'type': 'number'}, 'language': {'type': ['string', 'null']}, 'visibility': {'type': 'string'}, 'contentType': {'type': 'string'}}}

{'type': 'object', 'required': ['q'], 'properties': {'q': {'type': 'string', 'description': 'Search query matched against doc names.'}}}

{'type': 'object', 'required': ['docs'], 'properties': {'docs': {'type': 'array', 'items': {'type': 'object', 'required': ['handle', 'name', 'appUrl'], 'properties': {'name': {'type': 'string'}, 'appUrl': {'type': 'string'}, 'handle': {'type': 'string'}, 'latestVersion': {'type': 'number'}}}}, 'query': {'type': 'string'}}}