# NeetoKB Docs

> API, CLI, and MCP documentation for managing your NeetoKB knowledge base from external channels.

## Docs

- [Introduction](https://apidocs.neetokb.com/getting-started/introduction.md): Welcome to the NeetoKB API documentation.
- [Workspace subdomain](https://apidocs.neetokb.com/getting-started/workspace-subdomain.md): Learn how to find your workspace subdomain.
- [Authentication](https://apidocs.neetokb.com/getting-started/authentication.md): Learn how to authenticate your requests to the NeetoKB API using API keys.
- [Pagination](https://apidocs.neetokb.com/getting-started/pagination.md): Learn how to handle paginated responses in the NeetoKB API.
- [HTTP Response Codes](https://apidocs.neetokb.com/getting-started/response-codes.md): Learn about the HTTP status codes returned by the API.
- [Getting the Article ID](https://apidocs.neetokb.com/getting-started/getting-article-id.md): Understand how to retrieve article identifiers for use in your API calls.
- [Getting the Category ID](https://apidocs.neetokb.com/getting-started/getting-category-id.md): Understand how to retrieve category IDs for use in your API calls.
- [List articles](https://apidocs.neetokb.com/api-reference/articles/list.md): This API allows to get a list of all articles.
- [Create article](https://apidocs.neetokb.com/api-reference/articles/create.md): This API allows to create a new article.
- [Get article](https://apidocs.neetokb.com/api-reference/articles/get.md): This API allows to fetch article details.
- [Update article](https://apidocs.neetokb.com/api-reference/articles/update.md): This API allows to update an existing article.
- [Get unlisted link](https://apidocs.neetokb.com/api-reference/articles/get-unlisted-link.md): This API allows to fetch the article's unlisted (secret) share link, creating a never-expiring one if none exists yet. An expired link is automatically replaced with a fresh one.
- [Regenerate unlisted link](https://apidocs.neetokb.com/api-reference/articles/regenerate-unlisted-link.md): This API allows to generate a fresh unlisted link for the article, replacing any existing one. The previous URL stops working immediately.
- [Upload attachment](https://apidocs.neetokb.com/api-reference/attachments/create.md): Upload a file (such as an image, PDF, or document) and get back a link you can use inside an article, so you don't have to embed the full file directly in the article's content, which makes articles large and slow to load. For images, the response also includes `attachable_html`: the image already f…
- [List authors](https://apidocs.neetokb.com/api-reference/authors/list.md): This API allows to get a list of all authors.
- [List categories](https://apidocs.neetokb.com/api-reference/categories/list.md): This API allows to get a list of all categories.
- [Get recommended articles](https://apidocs.neetokb.com/api-reference/recommendations/get.md): This API returns recommended articles based on a specific URL or path.
- [Search articles](https://apidocs.neetokb.com/api-reference/search/get.md): This API runs a full-text search across the workspace's published articles. Results are ranked by relevance, with the title weighted highest, then content, slug, category name, and keywords. Each match includes highlighted snippets showing where the search term appears.
- [Get organization settings](https://apidocs.neetokb.com/api-reference/settings/get.md): This API allows to fetch organization settings.
- [List team members](https://apidocs.neetokb.com/api-reference/team-members/list.md): List team members in the workspace.
- [Get team member details](https://apidocs.neetokb.com/api-reference/team-members/get.md): Retrieves details of a specific team member.
- [Add team members](https://apidocs.neetokb.com/api-reference/team-members/add.md): Add team members to the workspace.
- [Update team member](https://apidocs.neetokb.com/api-reference/team-members/update.md): Update a team member.
- [Remove team member](https://apidocs.neetokb.com/api-reference/team-members/remove.md): Remove a team member from the workspace.
- [List articles](https://apidocs.neetokb.com/api-reference-v1/articles/list.md): This API allows to get a list of all articles.
- [Create article](https://apidocs.neetokb.com/api-reference-v1/articles/create.md): This API allows to create a new article.
- [Get article](https://apidocs.neetokb.com/api-reference-v1/articles/get.md): This API allows to fetch article details.
- [Update article](https://apidocs.neetokb.com/api-reference-v1/articles/update.md): This API allows to update an existing article.
- [List authors](https://apidocs.neetokb.com/api-reference-v1/authors/list.md): This API allows to get a list of all authors.
- [List categories](https://apidocs.neetokb.com/api-reference-v1/categories/list.md): This API allows to get a list of all categories.
- [Get recommended articles](https://apidocs.neetokb.com/api-reference-v1/recommendations/get.md): This API returns recommended articles based on a specific URL or path.
- [Get organization settings](https://apidocs.neetokb.com/api-reference-v1/settings/get.md): This API allows to fetch organization settings.
- [List team members](https://apidocs.neetokb.com/api-reference-v1/team-members/list.md): List team members in the workspace.
- [Add team members](https://apidocs.neetokb.com/api-reference-v1/team-members/add.md): Add team members to the workspace.
- [Update team member details](https://apidocs.neetokb.com/api-reference-v1/team-members/update.md): Update a team member.
- [Remove team member](https://apidocs.neetokb.com/api-reference-v1/team-members/remove.md): Remove a team member from the workspace.
- [NeetoKB CLI](https://apidocs.neetokb.com/cli/introduction.md): Manage articles, categories, authors, and team members from your terminal.
- [Installation](https://apidocs.neetokb.com/cli/installation.md): Install the neetokb CLI on macOS, Linux, or Windows.
- [Authentication](https://apidocs.neetokb.com/cli/authentication.md): Sign in through the browser and manage credentials for one or more workspaces.
- [Output formats](https://apidocs.neetokb.com/cli/output-formats.md): Pretty tables, JSON, quiet, and TOON - and when to use each.
- [AI assistants](https://apidocs.neetokb.com/cli/ai-assistants.md): Set up NeetoKB for Claude, Cursor, Copilot, and other AI coding assistants.
- [Troubleshooting](https://apidocs.neetokb.com/cli/troubleshooting.md): Diagnose authentication and connectivity issues with neetokb doctor.
- [Commands overview](https://apidocs.neetokb.com/cli-reference/overview.md): Every neetokb command grouped by resource, with links to the full reference.
- [Articles](https://apidocs.neetokb.com/cli-reference/articles.md): List, search, view, create, update, and share articles.
- [Categories](https://apidocs.neetokb.com/cli-reference/categories.md): List the categories that organize your knowledge base.
- [Authors](https://apidocs.neetokb.com/cli-reference/authors.md): List the people who have written articles in your knowledge base.
- [Recommendations](https://apidocs.neetokb.com/cli-reference/recommendations.md): Fetch the articles NeetoKB recommends for a page or URL.
- [Team members](https://apidocs.neetokb.com/cli-reference/team-members.md): List, view, invite, update, and remove team members.
- [Workspace](https://apidocs.neetokb.com/cli-reference/workspace.md): View the settings of the knowledge base you are signed in to.
- [Utility commands](https://apidocs.neetokb.com/cli-reference/utility.md): Authentication, diagnostics, versioning, updates, AI-assistant setup, and shell completion.
- [NeetoKB MCP](https://apidocs.neetokb.com/mcp/introduction.md): Manage your knowledge base from an AI assistant in plain language.
- [Authentication](https://apidocs.neetokb.com/mcp/authentication.md): Connect with OAuth for your own access, or an API key for the whole workspace.
- [Connect](https://apidocs.neetokb.com/mcp/connect.md): Point your AI assistant at the NeetoKB MCP server.
- [Examples](https://apidocs.neetokb.com/mcp/examples.md): Natural-language prompts for driving NeetoKB over MCP.
- [Troubleshooting](https://apidocs.neetokb.com/mcp/troubleshooting.md): Get the NeetoKB MCP server connected when the tools don't show up.
- [Tools](https://apidocs.neetokb.com/mcp/tools.md): The NeetoKB actions your AI assistant can perform over MCP.

## OpenAPI Specs

- [search](https://apidocs.neetokb.com/bundled/search.yaml)
- [attachments](https://apidocs.neetokb.com/bundled/attachments.yaml)
- [articles](https://apidocs.neetokb.com/bundled/articles.yaml)
- [team-members](https://apidocs.neetokb.com/bundled/team-members.yaml)
- [settings](https://apidocs.neetokb.com/bundled/settings.yaml)
- [recommendations](https://apidocs.neetokb.com/bundled/recommendations.yaml)
- [categories](https://apidocs.neetokb.com/bundled/categories.yaml)
- [authors](https://apidocs.neetokb.com/bundled/authors.yaml)
- [openapi](https://apidocs.neetokb.com/api-reference/openapi.json)