> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.ada.cx/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.ada.cx/_mcp/server.

# Article availability rules in the Knowledge API

The Knowledge API now supports availability rules on articles. An availability rule controls which articles are available to the AI Agent during a conversation, based on variables like language, user role, or any custom metadata.

A new `availability_rules` field is supported on:

* `GET /v2/knowledge/articles/` and `GET /v2/knowledge/articles/{id}`
* `POST /v2/knowledge/bulk/articles/`

Rules reference variables by `id`. Two new endpoints return the variables available to your Agent:

* `GET /v2/variables/`
* `GET /v2/variables/{id}`

See [Availability rules](/reference/introduction/availability-rules) for the full schema, operator list, and examples.

You can now set availability rules on knowledge articles via MCP. See the [propose\_change documentation](/mcp/tools/propose-change) for details.