# Articles

Everything about your Articles

 - [GET /articles](https://developers.intercom.com/docs/references/rest-api/api.intercom.io/articles/listarticles.md): You can fetch a list of all articles by making a GET request to `https://api.intercom.io/articles`. > 📘 How are the articles sorted and ordered? Articles will be returned in descending order on the `
 - [POST /articles](https://developers.intercom.com/docs/references/rest-api/api.intercom.io/articles/createarticle.md): You can create a new article by making a POST request to `https://api.intercom.io/articles`. > 📘 Tags cannot be managed via the Articles API Article tags are read-only in responses. To create, update
 - [GET /articles/{article_id}](https://developers.intercom.com/docs/references/rest-api/api.intercom.io/articles/retrievearticle.md): You can fetch the details of a single article by making a GET request to `https://api.intercom.io/articles/<id>`.
 - [PUT /articles/{article_id}](https://developers.intercom.com/docs/references/rest-api/api.intercom.io/articles/updatearticle.md): You can update the details of a single article by making a PUT request to `https://api.intercom.io/articles/<id>`. > 📘 Tags cannot be managed via the Articles API Article tags are read-only in respon
 - [DELETE /articles/{article_id}](https://developers.intercom.com/docs/references/rest-api/api.intercom.io/articles/deletearticle.md): You can delete a single article by making a DELETE request to `https://api.intercom.io/articles/<id>`.
 - [GET /articles/{id}/draft](https://developers.intercom.com/docs/references/rest-api/api.intercom.io/articles/retrievearticledraft.md): Fetch the staged draft of a published article by making a GET request to `https://api.intercom.io/articles/<id>/draft`. The response is the article rendered with its draft content, leaving the live ar
 - [PUT /articles/{id}/draft](https://developers.intercom.com/docs/references/rest-api/api.intercom.io/articles/stagearticledraft.md): Stage changes to a published article as a draft by making a PUT request to `https://api.intercom.io/articles/<id>/draft`. The live article remains unchanged until the draft is published. The article m
 - [POST /articles/{id}/draft/publish](https://developers.intercom.com/docs/references/rest-api/api.intercom.io/articles/publisharticledraft.md): Publish a staged draft by making a POST request to `https://api.intercom.io/articles/<id>/draft/publish`, promoting the draft content to live. On a single-language workspace no body is required. On a
 - [POST /articles/{article_id}/tags](https://developers.intercom.com/docs/references/rest-api/api.intercom.io/articles/attachtagtoarticle.md): Apply an existing tag to an article. Returns the tag that was applied. The tag must already exist in the workspace (create tags with the Tags API), and the authenticating teammate must have the `manag
 - [DELETE /articles/{article_id}/tags/{id}](https://developers.intercom.com/docs/references/rest-api/api.intercom.io/articles/detachtagfromarticle.md): Remove a tag from an article. Returns the tag that was removed, with null `applied_at` and `applied_by`. The authenticating teammate must have the `manage_knowledge_base_content` permission. Requires
 - [GET /articles/{article_id}/versions](https://developers.intercom.com/docs/references/rest-api/api.intercom.io/articles/listarticleversions.md): Fetch the version history of an article by making a GET request to `https://api.intercom.io/articles/<article_id>/versions`. Versions are returned newest-first as a paginated list of metadata. Use `GE
 - [GET /articles/{article_id}/versions/{id}](https://developers.intercom.com/docs/references/rest-api/api.intercom.io/articles/retrievearticleversion.md): Fetch a single prior version of an article, including its body content, by making a GET request to `https://api.intercom.io/articles/<article_id>/versions/<id>`. Returns the version's full content; th
 - [GET /articles/search](https://developers.intercom.com/docs/references/rest-api/api.intercom.io/articles/searcharticles.md): You can search for articles by making a GET request to `https://api.intercom.io/articles/search`.
 - [Article](https://developers.intercom.com/docs/references/rest-api/api.intercom.io/articles/article.md): Schema: #/components/schemas/article
 - [Articles](https://developers.intercom.com/docs/references/rest-api/api.intercom.io/articles/article_list_item.md): Schema: #/components/schemas/article_list_item
 - [Article Search Highlights](https://developers.intercom.com/docs/references/rest-api/api.intercom.io/articles/article_search_highlights.md): Schema: #/components/schemas/article_search_highlights
 - [Article Search Response](https://developers.intercom.com/docs/references/rest-api/api.intercom.io/articles/article_search_response.md): Schema: #/components/schemas/article_search_response
 - [Article Version](https://developers.intercom.com/docs/references/rest-api/api.intercom.io/articles/article_version.md): Schema: #/components/schemas/article_version
 - [Article Version Summary](https://developers.intercom.com/docs/references/rest-api/api.intercom.io/articles/article_version_summary.md): Schema: #/components/schemas/article_version_summary
 - [Internal Article](https://developers.intercom.com/docs/references/rest-api/api.intercom.io/articles/internal_article.md): Schema: #/components/schemas/internal_article
