# Weav

MCP server: https://docs.weav.com/mcp (Streamable HTTP, no auth)

Agent guide: https://docs.weav.com/agents.md

## Docs: Getting started
- [Explore](https://docs.weav.com/explore.md): Welcome to Weav! We're thrilled to help you transform how you connect with your customers.

## Docs: Quick Start
- [Configure workspace](https://docs.weav.com/configure-workspace.md): Set up your workspace basics so your team can start supporting customers quickly.
- [Build your first AI agent](https://docs.weav.com/build-your-first-ai-agent.md): Create, train, and deploy your first Weav AI Agent in minutes. Follow this step-by-step guide to get your intelligent assistant ready to help your customers. In just a few steps, you'll have a fully functional AI Agent capable of instantly
- [Train your AI agents](https://docs.weav.com/train-your-agents.md): Add knowledge to your AI agents using text, websites, files, videos, and Q&A.
- [Connect channels](https://docs.weav.com/connect-channels.md): Connect chat and email so your AI agent can start handling real customer conversations.

## Docs: Agents
- [General settings](https://docs.weav.com/general-settings.md): Learn what each setting does in the agent Settings tab, with practical guidance for tone, response length, prohibited phrases, and context.
- [Chat settings](https://docs.weav.com/chat-settings.md): Your agent’s Chat settings control how your website chat widget looks, how it behaves, and how safely it handles conversations.
- [Email settings](https://docs.weav.com/email-settings.md): The Email settings page controls how your agent handles inbound email conversations for your workspace.
- [Playground](https://docs.weav.com/playground.md): Test your AI agent’s real response behavior safely.
- [Escalation Rules](https://docs.weav.com/escalation-rules.md): Control when your AI agent hands off conversations to your team using escalation rules.
- [Prohibited Phrases](https://docs.weav.com/prohibited-phrases.md): Control what your AI agent never says by listing phrases it must avoid in every response.
- [Chat Quick Prompts](https://docs.weav.com/quick-prompts.md): Add one-tap question buttons or links above the chat input so customers can start conversations quickly.
- [Supported Languages](https://docs.weav.com/supported-languages.md): Weav's AI agent answers your customers in more than 100 languages.
- [Proactive messages](https://docs.weav.com/proactive-messages.md): Proactive messages start the conversation before a visitor asks. Your chat widget shows a short greeting based on what the visitor is doing on your site. When the visitor clicks it, your AI agent follows up and the conversation begins.

## Docs: Inbox
- [Set up a custom email](https://docs.weav.com/forward-emails-to-weav.md): Connect your own email address (like help@yourcompany.com) so your team can send and receive branded emails in Weav.
- [Email forwarding](https://docs.weav.com/email-forwarding.md): How to forward emails from your email address to Weav using Google Workspace, Microsoft 365, or other providers.
- [Add DNS records at your domain provider](https://docs.weav.com/dns-settings.md): Configure the DKIM and Return Path DNS records at Cloudflare, GoDaddy, Namecheap, or Squarespace so you can send email from your custom domain in Weav.
- [Connect a Google Workspace Group inbox](https://docs.weav.com/google-groups-setup.md): A Google Group is a shared address (like support@yourcompany.com) that delivers email to several people at once. It’s not a normal mailbox — it’s more like a list. That makes connecting it to Weav slightly different from connecting a

## Docs: Settings
- [Overview](https://docs.weav.com/settings-overview.md): A high-level guide to the settings available in Weav and what you can control from each page.
- [Customer support workflows](https://docs.weav.com/workflows.md): Automate common support steps so customers get faster responses and conversations reach the right place.

## Docs: Integrations
- [Customer verification for agent actions](https://docs.weav.com/customer-verification.md): Learn how Weav verifies customers before AI agents use sensitive custom actions and integration tools.
- [Custom actions](https://docs.weav.com/custom-actions.md): A guide explaining how to connect AI agents to 3rd party API's
- [Framer](https://docs.weav.com/framer.md): Learn how to install Weav on your Framer site, customize the chat launcher, and open chat from canvas layers.
- [Google Drive](https://docs.weav.com/google-drive.md): Learn how to connect Google Drive with your Weav AI Agents
- [Shopify](https://docs.weav.com/shopify.md): Learn how to connect Shopify with your AI Agents
- [Stripe](https://docs.weav.com/stripe.md): Learn how to connect Stripe with your Weav AI Agents
- [WhatsApp](https://docs.weav.com/whatsapp.md): ![Whats App](./images/WhatsApp.png "Whats App")

## Developers: API documentation
- [Introduction](https://docs.weav.com/developers/api-introduction.md): Build secure, real-time customer support integrations with the Weav API and webhooks.
- [Programmable Chatbot](https://docs.weav.com/developers/programmable-chatbot.md): The Weav Chatbot Widget is a lightweight, embeddable chat interface that lets you add AI-powered customer support to any website.
- [Weav MCP](https://docs.weav.com/developers/mcp.md): The Weav MCP server lets AI tools access your workspace through the Model Context Protocol. After a workspace admin or owner completes OAuth consent, those tools can work with conversations, customers, and training data in that workspace.
- [Webhook delivery](https://docs.weav.com/developers/webhook-delivery.md): When subscribed events occur, Weav sends an HTTPS POST request to your configured webhook URL.

## Developers: Agents
- [List agents](https://docs.weav.com/developers/list-agents.md): Retrieve a paginated list of agents for the authenticated organization
- [Create agent](https://docs.weav.com/developers/create-agent.md): Create a new AI agent for the authenticated organization
- [Get agent](https://docs.weav.com/developers/get-agent.md): Retrieve a specific agent by ID
- [Update agent](https://docs.weav.com/developers/update-agent.md): Update an existing agent. Cannot update copilot agents.
- [Delete agent](https://docs.weav.com/developers/delete-agent.md): Delete an agent. Cannot delete copilot agents.

## Developers: Companies
- [List companies](https://docs.weav.com/developers/list-companies.md): Requires a token with the external-api:read or external-api:write ability. per_page integer Default: 15 Minimum: 1. Maximum: 100. page integer Default: 1 Minimum: 1. cURL JavaScript Python PHP cURL JavaScript Python PHP 200 OK 200 OK 401 Unauthorized id string Format: uuid . name string domain…
- [Create company](https://docs.weav.com/developers/create-company.md): Requires a token with the external-api:write ability. name string required Maximum length: 50. domain string | null Maximum length: 255. country string | null ISO 3166-1 alpha-2 country code (2 uppercase letters) cURL JavaScript Python PHP cURL JavaScript Python PHP 201 Created 201 Created 400 Bad…
- [Get company](https://docs.weav.com/developers/get-company.md): Requires a token with the external-api:read or external-api:write ability. id string required Format: uuid . cURL JavaScript Python PHP cURL JavaScript Python PHP 200 OK 200 OK 404 Not Found 401 Unauthorized id string Format: uuid . name string domain string country string | null avatar_url string…
- [Update company](https://docs.weav.com/developers/update-company.md): Requires a token with the external-api:write ability. id string required Format: uuid . name string Maximum length: 50. domain string | null country string | null ISO 3166-1 alpha-2 country code (2 uppercase letters) cURL JavaScript Python PHP cURL JavaScript Python PHP 200 OK 200 OK 400 Bad…
- [Delete company](https://docs.weav.com/developers/delete-company.md): Requires a token with the external-api:write ability. id string required Format: uuid . cURL JavaScript Python PHP cURL JavaScript Python PHP 204 No Content 404 Not Found 401 Unauthorized
- [List customers for company](https://docs.weav.com/developers/list-customers-for-company.md): Requires a token with the external-api:read or external-api:write ability. id string required Format: uuid . per_page integer Default: 15 Minimum: 1. Maximum: 100. page integer Default: 1 Minimum: 1. cURL JavaScript Python PHP cURL JavaScript Python PHP 200 OK 200 OK 404 Not Found 401 Unauthorized…

## Developers: Conversations
- [List conversations](https://docs.weav.com/developers/list-conversations.md): Requires a token with the external-api:read or external-api:write ability. per_page integer Default: 15 Minimum: 1. Maximum: 100. page integer Default: 1 Minimum: 1. status string Filter by status One of: open , closed . channel string Filter by channel One of: email , chat . cURL JavaScript…
- [Create conversation](https://docs.weav.com/developers/create-conversation.md): Create a new conversation. Assignment Rules: assignees must belong to the same workspace as the API key. Chat conversations can be assigned to users (or left unassigned). Agent assignment is limited to the conversation's original chat agent. Email conversations can be assigned to users, left…
- [Get conversation](https://docs.weav.com/developers/get-conversation.md): Requires a token with the external-api:read or external-api:write ability. id string required Format: uuid . cURL JavaScript Python PHP cURL JavaScript Python PHP 200 OK 200 OK 404 Not Found 401 Unauthorized id string Format: uuid . channel string One of: email , chat . customer_id string Format:…
- [Update conversation](https://docs.weav.com/developers/update-conversation.md): Update an existing conversation. Assignment Rules: assignees must belong to the same workspace as the API key. Chat conversations can be assigned to users, left unassigned, or only to the conversation's original chat agent. Email conversations can be assigned to users, left unassigned, or only to…
- [Delete conversation](https://docs.weav.com/developers/delete-conversation.md): Requires a token with the external-api:write ability. id string required Format: uuid . cURL JavaScript Python PHP cURL JavaScript Python PHP 204 No Content 404 Not Found 401 Unauthorized
- [List messages in conversation](https://docs.weav.com/developers/list-messages-in-conversation.md): Requires a token with the external-api:read or external-api:write ability. id string required Format: uuid . per_page integer Default: 15 Minimum: 1. Maximum: 100. page integer Default: 1 Minimum: 1. cURL JavaScript Python PHP cURL JavaScript Python PHP 200 OK 200 OK 404 Not Found 401 Unauthorized…

## Developers: Customers
- [List customers](https://docs.weav.com/developers/list-customers.md): Requires a token with the external-api:read or external-api:write ability. per_page integer Default: 15 Minimum: 1. Maximum: 100. page integer Default: 1 Minimum: 1. is_lead boolean Filter by leads email string Filter by email cURL JavaScript Python PHP cURL JavaScript Python PHP 200 OK 200 OK 401…
- [Create customer](https://docs.weav.com/developers/create-customer.md): Requires a token with the external-api:write ability. email string required Format: email . first_name string | null last_name string | null phone string | null locale string | null country string | null region string | null Maximum length: 10. city string | null Maximum length: 64. timezone…
- [Get customer](https://docs.weav.com/developers/get-customer.md): Requires a token with the external-api:read or external-api:write ability. id string required Format: uuid . cURL JavaScript Python PHP cURL JavaScript Python PHP 200 OK 200 OK 404 Not Found 401 Unauthorized id string Format: uuid . first_name string | null last_name string | null email string…
- [Update customer](https://docs.weav.com/developers/update-customer.md): Requires a token with the external-api:write ability. id string required Format: uuid . email string Format: email . first_name string | null last_name string | null phone string | null locale string | null country string | null region string | null Maximum length: 10. city string | null Maximum…
- [Delete customer](https://docs.weav.com/developers/delete-customer.md): Requires a token with the external-api:write ability. id string required Format: uuid . cURL JavaScript Python PHP cURL JavaScript Python PHP 204 No Content 404 Not Found 401 Unauthorized
- [List customer conversations](https://docs.weav.com/developers/list-customer-conversations.md): Requires a token with the external-api:read or external-api:write ability. id string required Format: uuid . per_page integer Default: 15 Minimum: 1. Maximum: 100. page integer Default: 1 Minimum: 1. cURL JavaScript Python PHP cURL JavaScript Python PHP 200 OK 200 OK 404 Not Found 401 Unauthorized…

## Developers: Messages
- [List messages](https://docs.weav.com/developers/list-messages.md): Requires a token with the external-api:read or external-api:write ability. per_page integer Default: 15 Minimum: 1. Maximum: 100. page integer Default: 1 Minimum: 1. conversation_id string Filter by conversation Format: uuid . sender_type string Filter by sender type One of: customer , user ,…
- [Create message](https://docs.weav.com/developers/create-message.md): Note: API currently validates sender_type as customer|user. The API does not accept `metadata` or `is_ai_assisted` in requests.
- [Get message](https://docs.weav.com/developers/get-message.md): Requires a token with the external-api:read or external-api:write ability. id string required Format: uuid . cURL JavaScript Python PHP cURL JavaScript Python PHP 200 OK 200 OK 404 Not Found 401 Unauthorized id string Format: uuid . conversation_id string Format: uuid . sender_type string One of:…
- [Delete message](https://docs.weav.com/developers/delete-message.md): Requires a token with the external-api:write ability. id string required Format: uuid . cURL JavaScript Python PHP cURL JavaScript Python PHP 204 No Content 404 Not Found 401 Unauthorized

## Developers: Training Data
- [List training data](https://docs.weav.com/developers/list-training-data.md): Requires a token with the external-api:read or external-api:write ability. per_page integer Default: 15 Minimum: 1. Maximum: 100. page integer Default: 1 Minimum: 1. type string Filter by type One of: text , url , file , video , qa . status string Filter by status One of: queued , processing ,…
- [Create training data](https://docs.weav.com/developers/create-training-data.md): Create training data. Supports multiple types: text, url, file, video, qa. Processing happens automatically in the background.
- [Process URLs into training data](https://docs.weav.com/developers/process-urls-into-training-data.md): Creates URL training data from the provided URLs. In production, URL processing jobs are queued and run asynchronously.
- [Check if a URL already exists](https://docs.weav.com/developers/check-if-a-url-already-exists.md): Checks whether a normalized URL already exists in completed URL training data for the current organization.
- [Manually trigger URL resync](https://docs.weav.com/developers/manually-trigger-url-resync.md): Requires a token with the external-api:write ability. id string required URL training data UUID Format: uuid . cURL JavaScript Python PHP cURL JavaScript Python PHP 200 OK 404 Not Found 422 Unprocessable Content 200 OK 404 Not Found 422 Unprocessable Content 401 Unauthorized training_data_id…
- [Get training data](https://docs.weav.com/developers/get-training-data.md): Requires a token with the external-api:read or external-api:write ability. id string required Format: uuid . cURL JavaScript Python PHP cURL JavaScript Python PHP 200 OK 200 OK 404 Not Found 401 Unauthorized id string Format: uuid . type string One of: text , url , file , video , qa . source…
- [Update training data](https://docs.weav.com/developers/update-training-data.md): The API does not accept `metadata` in requests.
- [Delete training data](https://docs.weav.com/developers/delete-training-data.md): Requires a token with the external-api:write ability. id string required Format: uuid . cURL JavaScript Python PHP cURL JavaScript Python PHP 204 No Content 404 Not Found 401 Unauthorized

## Developers: Knowledge Base
- [Get knowledge base](https://docs.weav.com/developers/get-knowledge-base.md): Requires a token with the external-api:read or external-api:write ability. cURL JavaScript Python PHP cURL JavaScript Python PHP 200 OK 200 OK 401 Unauthorized id string Format: uuid . organization_id string Format: uuid . logo_url string | null improvement_enabled boolean mcp_enabled boolean…
- [Update knowledge base settings](https://docs.weav.com/developers/update-knowledge-base-settings.md): Requires a token with the external-api:write ability. improvement_enabled boolean Whether teammate corrections can propose KB drafts. mcp_enabled boolean Whether the public MCP server and WebMCP tools are available at the KB's /mcp URL. ask_ai_enabled boolean Whether the KB search box offers Ask…
- [Upload knowledge base logo](https://docs.weav.com/developers/upload-knowledge-base-logo.md): Requires a token with the external-api:write ability. cURL JavaScript Python PHP cURL JavaScript Python PHP 200 OK
- [Delete knowledge base logo](https://docs.weav.com/developers/delete-knowledge-base-logo.md): Requires a token with the external-api:write ability. cURL JavaScript Python PHP cURL JavaScript Python PHP 200 OK

## Developers: Articles
- [List articles](https://docs.weav.com/developers/list-articles.md): Requires a token with the external-api:read or external-api:write ability. category_id string Format: uuid . status string One of: draft , published . updated_since string Format: date-time . per_page integer Default: 15 Minimum: 1. Maximum: 100. page integer Default: 1 Minimum: 1. cURL JavaScript…
- [Create article](https://docs.weav.com/developers/create-article.md): Lazily creates the organization's knowledge base if this is its first write. Accepts one or more locale translations.
- [Get article](https://docs.weav.com/developers/get-article.md): Requires a token with the external-api:read or external-api:write ability. id string required Format: uuid . cURL JavaScript Python PHP cURL JavaScript Python PHP 200 OK 200 OK 404 Not Found 401 Unauthorized id string Format: uuid . category_id string | null Format: uuid . position integer | null…
- [Update article](https://docs.weav.com/developers/update-article.md): Updating an existing locale's title, content, excerpt, or slug records a revision of its prior content. SEO-only changes do not create a revision. Adding a new locale requires both title and content.
- [Delete article](https://docs.weav.com/developers/delete-article.md): Soft-deletes the article.
- [Get draft article preview link](https://docs.weav.com/developers/get-draft-article-preview-link.md): Requires a token with the external-api:write ability. id string required Format: uuid . cURL JavaScript Python PHP cURL JavaScript Python PHP 200 OK 200 OK 404 Not Found 409 Conflict 401 Unauthorized preview_url string Format: uri .
- [Regenerate draft article preview link](https://docs.weav.com/developers/regenerate-draft-article-preview-link.md): Requires a token with the external-api:write ability. id string required Format: uuid . cURL JavaScript Python PHP cURL JavaScript Python PHP 200 OK 200 OK 404 Not Found 409 Conflict 401 Unauthorized preview_url string Format: uri .
- [Reorder articles](https://docs.weav.com/developers/reorder-articles.md): Assign display positions 0..n-1 for every article in one category group. Pass `category_id: null` for the uncategorized group.
- [Publish article](https://docs.weav.com/developers/publish-article.md): Sets status to published and records published_at (preserved across further edits; reset on the next publish after an unpublish). Immediately visible on the public read surface.
- [Unpublish article](https://docs.weav.com/developers/unpublish-article.md): Sets status back to draft and clears published_at. Removed from the public read surface immediately.
- [Upload article image](https://docs.weav.com/developers/upload-article-image.md): Requires a token with the external-api:write ability. id string required Format: uuid . image file required JPEG, PNG, GIF, or WebP image up to 5 MB Format: binary . cURL JavaScript Python PHP cURL JavaScript Python PHP 201 Created 201 Created url string Format: uri . key string
- [Delete article image](https://docs.weav.com/developers/delete-article-image.md): Requires a token with the external-api:write ability. cURL JavaScript Python PHP cURL JavaScript Python PHP 204 No Content
- [List article revisions](https://docs.weav.com/developers/list-article-revisions.md): Requires a token with the external-api:read or external-api:write ability. id string required Format: uuid . locale string Maximum length: 10. per_page integer Default: 15 Minimum: 1. Maximum: 100. page integer Default: 1 Minimum: 1. cURL JavaScript Python PHP cURL JavaScript Python PHP 200 OK 200…
- [Get article revision](https://docs.weav.com/developers/get-article-revision.md): Requires a token with the external-api:read or external-api:write ability. id string required Format: uuid . revisionId string required Format: uuid . cURL JavaScript Python PHP cURL JavaScript Python PHP 200 OK 200 OK 404 Not Found 401 Unauthorized id string Format: uuid . locale string title…
- [Restore article revision](https://docs.weav.com/developers/restore-article-revision.md): Snapshots the translation's current content as a new revision, then overwrites it with the selected revision's content.

## Developers: Categories
- [List categories](https://docs.weav.com/developers/list-categories.md): Requires a token with the external-api:read or external-api:write ability. per_page integer Default: 15 Minimum: 1. Maximum: 100. page integer Default: 1 Minimum: 1. cURL JavaScript Python PHP cURL JavaScript Python PHP 200 OK 200 OK 401 Unauthorized id string Format: uuid . name string slug…
- [Create category](https://docs.weav.com/developers/create-category.md): Lazily creates the organization's knowledge base if this is its first write.
- [Get category](https://docs.weav.com/developers/get-category.md): Requires a token with the external-api:read or external-api:write ability. id string required Format: uuid . cURL JavaScript Python PHP cURL JavaScript Python PHP 200 OK 200 OK 404 Not Found 401 Unauthorized id string Format: uuid . name string slug string section_id string | null Format: uuid .…
- [Update category](https://docs.weav.com/developers/update-category.md): Requires a token with the external-api:write ability. id string required Format: uuid . name string Maximum length: 255. slug string | null Maximum length: 255. section_id string | null Format: uuid . cURL JavaScript Python PHP cURL JavaScript Python PHP 200 OK 200 OK 422 Unprocessable Content 404…
- [Delete category](https://docs.weav.com/developers/delete-category.md): Soft-deletes the category and clears it from articles that referenced it.
- [Reorder categories](https://docs.weav.com/developers/reorder-categories.md): Assign display positions 0..n-1 for every category in the knowledge base.

## Developers: Sections
- [List sections](https://docs.weav.com/developers/list-sections.md): Requires a token with the external-api:read or external-api:write ability. per_page integer Default: 15 Minimum: 1. Maximum: 100. page integer Default: 1 Minimum: 1. cURL JavaScript Python PHP cURL JavaScript Python PHP 200 OK 200 OK id string Format: uuid . name string slug string position…
- [Create section](https://docs.weav.com/developers/create-section.md): Requires a token with the external-api:write ability. name string required slug string | null position integer | null cURL JavaScript Python PHP cURL JavaScript Python PHP 201 Created 201 Created 422 Unprocessable Content id string Format: uuid . name string slug string position integer | null…
- [Get section](https://docs.weav.com/developers/get-section.md): Requires a token with the external-api:read or external-api:write ability. id string required Format: uuid . cURL JavaScript Python PHP cURL JavaScript Python PHP 200 OK 200 OK 404 Not Found id string Format: uuid . name string slug string position integer | null created_at string | null Format:…
- [Update section](https://docs.weav.com/developers/update-section.md): Requires a token with the external-api:write ability. id string required Format: uuid . name string slug string | null position integer | null cURL JavaScript Python PHP cURL JavaScript Python PHP 200 OK 200 OK 422 Unprocessable Content 404 Not Found id string Format: uuid . name string slug…
- [Delete section](https://docs.weav.com/developers/delete-section.md): Requires a token with the external-api:write ability. id string required Format: uuid . cURL JavaScript Python PHP cURL JavaScript Python PHP 204 No Content 404 Not Found
- [Reorder sections](https://docs.weav.com/developers/reorder-sections.md): Requires a token with the external-api:write ability. ids array<string> required cURL JavaScript Python PHP cURL JavaScript Python PHP 200 OK 422 Unprocessable Content

## Developers: Proposals
- [List improvement proposals](https://docs.weav.com/developers/list-improvement-proposals.md): Requires a token with the external-api:read or external-api:write ability. status string One of: pending , needs_decision , published , dismissed , ignored . per_page integer Default: 15 Minimum: 1. Maximum: 100. page integer Default: 1 Minimum: 1. cURL JavaScript Python PHP cURL JavaScript Python…
- [Get improvement proposal](https://docs.weav.com/developers/get-improvement-proposal.md): Requires a token with the external-api:read or external-api:write ability. id string required Format: uuid . cURL JavaScript Python PHP cURL JavaScript Python PHP 200 OK 404 Not Found
- [Set proposal category](https://docs.weav.com/developers/set-proposal-category.md): Requires a token with the external-api:write ability. id string required Format: uuid . category_id string | null required Format: uuid . cURL JavaScript Python PHP cURL JavaScript Python PHP 200 OK 422 Unprocessable Content 409 Conflict
- [Get pending proposal preview link](https://docs.weav.com/developers/get-pending-proposal-preview-link.md): Requires a token with the external-api:write ability. id string required Format: uuid . cURL JavaScript Python PHP cURL JavaScript Python PHP 200 OK 200 OK 404 Not Found 409 Conflict 401 Unauthorized preview_url string Format: uri .
- [Regenerate pending proposal preview link](https://docs.weav.com/developers/regenerate-pending-proposal-preview-link.md): Requires a token with the external-api:write ability. id string required Format: uuid . cURL JavaScript Python PHP cURL JavaScript Python PHP 200 OK 200 OK 404 Not Found 409 Conflict 401 Unauthorized preview_url string Format: uri .
- [Publish improvement proposal](https://docs.weav.com/developers/publish-improvement-proposal.md): Requires a token with the external-api:write ability. id string required Format: uuid . cURL JavaScript Python PHP cURL JavaScript Python PHP 200 OK 409 Conflict
- [Dismiss improvement proposal](https://docs.weav.com/developers/dismiss-improvement-proposal.md): Requires a token with the external-api:write ability. id string required Format: uuid . cURL JavaScript Python PHP cURL JavaScript Python PHP 200 OK 409 Conflict
- [Revise improvement proposal](https://docs.weav.com/developers/revise-improvement-proposal.md): Requires a token with the external-api:write ability. id string required Format: uuid . instruction string required Maximum length: 2000. cURL JavaScript Python PHP cURL JavaScript Python PHP 200 OK 409 Conflict
- [Choose proposal version](https://docs.weav.com/developers/choose-proposal-version.md): Requires a token with the external-api:write ability. id string required Format: uuid . choice string required One of: current , incoming , merged . cURL JavaScript Python PHP cURL JavaScript Python PHP 200 OK 409 Conflict

## Developers: Redirects
- [List redirects](https://docs.weav.com/developers/list-redirects.md): Requires a token with the external-api:read or external-api:write ability. per_page integer Default: 15 Minimum: 1. Maximum: 100. page integer Default: 1 Minimum: 1. cURL JavaScript Python PHP cURL JavaScript Python PHP 200 OK 200 OK 401 Unauthorized id string Format: uuid . path string article_id…
- [Create or update redirect](https://docs.weav.com/developers/create-or-update-redirect.md): Requires a token with the external-api:write ability. path string required Maximum length: 255. article_id string required Format: uuid . locale string | null cURL JavaScript Python PHP cURL JavaScript Python PHP 201 Created 200 OK 201 Created 200 OK 422 Unprocessable Content id string Format:…
- [Delete redirect](https://docs.weav.com/developers/delete-redirect.md): Requires a token with the external-api:write ability. id string required Format: uuid . cURL JavaScript Python PHP cURL JavaScript Python PHP 204 No Content 404 Not Found

## Developers: Search
- [Search articles](https://docs.weav.com/developers/search-articles.md): Requires a token with the external-api:read or external-api:write ability. q string required locale string Defaults to the organization's default_locale when omitted Maximum length: 10. status string One of: draft , published . category_id string Format: uuid . uncategorized boolean per_page…

This knowledge base is built and hosted on [Weav](https://weav.com).