# Internal Articles

Everything about your Internal Articles

## List all articles

 - [GET /internal_articles](https://developers.intercom.com/docs/references/rest-api/api.intercom.io/internal-articles/listinternalarticles.md): You can fetch a list of all internal articles by making a GET request to https://api.intercom.io/internal_articles.

## Create an internal article

 - [POST /internal_articles](https://developers.intercom.com/docs/references/rest-api/api.intercom.io/internal-articles/createinternalarticle.md): You can create a new internal article by making a POST request to https://api.intercom.io/internal_articles.

## Retrieve an internal article

 - [GET /internal_articles/{internal_article_id}](https://developers.intercom.com/docs/references/rest-api/api.intercom.io/internal-articles/retrieveinternalarticle.md): You can fetch the details of a single internal article by making a GET request to https://api.intercom.io/internal_articles/.

## Update an internal article

 - [PUT /internal_articles/{internal_article_id}](https://developers.intercom.com/docs/references/rest-api/api.intercom.io/internal-articles/updateinternalarticle.md): You can update the details of a single internal article by making a PUT request to https://api.intercom.io/internal_articles/.

## Delete an internal article

 - [DELETE /internal_articles/{internal_article_id}](https://developers.intercom.com/docs/references/rest-api/api.intercom.io/internal-articles/deleteinternalarticle.md): You can delete a single internal article by making a DELETE request to https://api.intercom.io/internal_articles/.

## Add a tag to an internal article

 - [POST /internal_articles/{internal_article_id}/tags](https://developers.intercom.com/docs/references/rest-api/api.intercom.io/internal-articles/attachtagtointernalarticle.md): Apply an existing tag to an internal 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 manage_knowledge_base_content
permission.

Requires the read_write_articles_scope OAuth scope.

## Remove a tag from an internal article

 - [DELETE /internal_articles/{internal_article_id}/tags/{id}](https://developers.intercom.com/docs/references/rest-api/api.intercom.io/internal-articles/detachtagfrominternalarticle.md): Remove a tag from an internal 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 the read_write_articles_scope OAuth scope.

## Search for internal articles

 - [GET /internal_articles/search](https://developers.intercom.com/docs/references/rest-api/api.intercom.io/internal-articles/searchinternalarticles.md): You can search for internal articles by making a GET request to https://api.intercom.io/internal_articles/search.

## Add a tag to an internal article

 - [POST /internal_articles/{internal_article_id}/tags](https://developers.intercom.com/docs/references/rest-api/api.intercom.io/tags/attachtagtointernalarticle.md): Apply an existing tag to an internal 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 manage_knowledge_base_content
permission.

Requires the read_write_articles_scope OAuth scope.

## Remove a tag from an internal article

 - [DELETE /internal_articles/{internal_article_id}/tags/{id}](https://developers.intercom.com/docs/references/rest-api/api.intercom.io/tags/detachtagfrominternalarticle.md): Remove a tag from an internal 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 the read_write_articles_scope OAuth scope.