> This page is for Unified.

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

The `Article` object is used to represent a form of content in the knowledge base, such as an article or page.

### The Article Object

```json
{
  "id": "string",
  "remote_id": "string",
  "created_at": "2023-01-01T00:00:00Z",
  "modified_at": "2023-01-01T00:00:00Z",
  "title": "string",
  "description": "string",
  "author": "string",
  "last_edited_by": "string",
  "visibility": "PUBLIC",
  "article_content_download_url": "string",
  "checksum": "string",
  "article_url": "string",
  "status": "DRAFT",
  "type": "PAGE",
  "remote_created_at": "2023-01-01T00:00:00Z",
  "remote_updated_at": "2023-01-01T00:00:00Z",
  "parent_article": "string",
  "parent_container": "string",
  "root_container": "string",
  "permissions": [
    {
      "id": "string",
      "remote_id": "string",
      "created_at": "2023-01-01T00:00:00Z",
      "modified_at": "2023-01-01T00:00:00Z",
      "user": "string",
      "group": "string",
      "type": "USER",
      "roles": [
        "READ"
      ],
      "remote_was_deleted": true,
      "field_mappings": {}
    }
  ],
  "attachments": [
    "string"
  ],
  "remote_was_deleted": true,
  "field_mappings": {},
  "remote_data": [
    {
      "path": "string",
      "data": {}
    }
  ]
}
```

### Schema (`Article`)

```yaml
components:
  schemas:
    VisibilityEnum:
      type: string
      enum:
        - PUBLIC
        - INTERNAL
        - RESTRICTED
      description: |-
        * `PUBLIC` - PUBLIC
        * `INTERNAL` - INTERNAL
        * `RESTRICTED` - RESTRICTED
      title: VisibilityEnum
    Status3c6Enum:
      type: string
      enum:
        - DRAFT
        - PUBLISHED
        - ARCHIVED
        - TRASH
      description: |-
        * `DRAFT` - DRAFT
        * `PUBLISHED` - PUBLISHED
        * `ARCHIVED` - ARCHIVED
        * `TRASH` - TRASH
      title: Status3c6Enum
    ArticleTypeEnum:
      type: string
      enum:
        - PAGE
        - BLOG_POST
        - SMART_LINK
      description: |-
        * `PAGE` - PAGE
        * `BLOG_POST` - BLOG_POST
        * `SMART_LINK` - SMART_LINK
      title: ArticleTypeEnum
    PermissionTypeEnum:
      type: string
      enum:
        - USER
        - GROUP
        - COMPANY
        - ANYONE
      description: |-
        * `USER` - USER
        * `GROUP` - GROUP
        * `COMPANY` - COMPANY
        * `ANYONE` - ANYONE
      title: PermissionTypeEnum
    RolesEnum:
      type: string
      enum:
        - READ
        - WRITE
        - OWNER
      description: |-
        * `READ` - READ
        * `WRITE` - WRITE
        * `OWNER` - OWNER
      title: RolesEnum
    PermissionFieldMappings:
      type: object
      properties: {}
      title: PermissionFieldMappings
    Permission:
      type: object
      properties:
        id:
          type: string
          format: uuid
        remote_id:
          type:
            - string
            - 'null'
          description: The third-party API ID of the matching object.
        created_at:
          type: string
          format: date-time
          description: The datetime that this object was created by Merge.
        modified_at:
          type: string
          format: date-time
          description: The datetime that this object was modified by Merge.
        user:
          type:
            - string
            - 'null'
          format: uuid
        group:
          type:
            - string
            - 'null'
          format: uuid
        type:
          oneOf:
            - $ref: '#/components/schemas/PermissionTypeEnum'
            - type: 'null'
          description: |-
            Denotes what type of people have access to the Article or Container.

            * `USER` - USER
            * `GROUP` - GROUP
            * `COMPANY` - COMPANY
            * `ANYONE` - ANYONE
        roles:
          type:
            - array
            - 'null'
          items:
            $ref: '#/components/schemas/RolesEnum'
          description: >-
            The permissions that the user or group has for the Article or
            Container. It is possible for a user or group to have multiple
            roles, such as viewing & uploading.
        remote_was_deleted:
          type: boolean
          description: >-
            Indicates whether or not this object has been deleted in the third
            party platform. Full coverage deletion detection is a premium
            add-on. Native deletion detection is offered for free with limited
            coverage. [Learn
            more](https://docs.merge.dev/integrations/hris/supported-features/).
        field_mappings:
          oneOf:
            - $ref: '#/components/schemas/PermissionFieldMappings'
            - type: 'null'
      description: >-
        # The Permission Object

        ### Description

        The `Permission` object is used to represent a user's or group's access
        to an article or container. Permissions are unexpanded by default.

        ### Usage Example
      title: Permission
    ArticleFieldMappings:
      type: object
      properties: {}
      title: ArticleFieldMappings
    RemoteData:
      type: object
      properties:
        path:
          type: string
          description: The third-party API path that is being called.
        data:
          description: >-
            The data returned from the third-party for this object in its
            original, unnormalized format.
      required:
        - path
      description: >-
        # The RemoteData Object

        ### Description

        The `RemoteData` object is used to represent the full data pulled from
        the third-party API for an object.
      title: RemoteData
    Article:
      type: object
      properties:
        id:
          type: string
          format: uuid
        remote_id:
          type:
            - string
            - 'null'
          description: The third-party API ID of the matching object.
        created_at:
          type: string
          format: date-time
          description: The datetime that this object was created by Merge.
        modified_at:
          type: string
          format: date-time
          description: The datetime that this object was modified by Merge.
        title:
          type:
            - string
            - 'null'
          maxLength: 254
          description: The title of the article.
        description:
          type:
            - string
            - 'null'
          maxLength: 2000
          description: Description of the article.
        author:
          type:
            - string
            - 'null'
          format: uuid
          description: The user who created the article.
        last_edited_by:
          type:
            - string
            - 'null'
          format: uuid
          description: The user to last update the article.
        visibility:
          oneOf:
            - $ref: '#/components/schemas/VisibilityEnum'
            - type: 'null'
          description: |-
            The visibility of the article.

            * `PUBLIC` - PUBLIC
            * `INTERNAL` - INTERNAL
            * `RESTRICTED` - RESTRICTED
        article_content_download_url:
          type:
            - string
            - 'null'
          description: The presigned S3 URL to fetch article content.
        checksum:
          type:
            - string
            - 'null'
          maxLength: 254
          description: The SHA256 checksum of the article content.
        article_url:
          type:
            - string
            - 'null'
          maxLength: 2000
          description: The URL to the webpage of the article.
        status:
          oneOf:
            - $ref: '#/components/schemas/Status3c6Enum'
            - type: 'null'
          description: |-
            The status of the article.

            * `DRAFT` - DRAFT
            * `PUBLISHED` - PUBLISHED
            * `ARCHIVED` - ARCHIVED
            * `TRASH` - TRASH
        type:
          oneOf:
            - $ref: '#/components/schemas/ArticleTypeEnum'
            - type: 'null'
          description: |-
            The type of the article.

            * `PAGE` - PAGE
            * `BLOG_POST` - BLOG_POST
            * `SMART_LINK` - SMART_LINK
        remote_created_at:
          type:
            - string
            - 'null'
          format: date-time
          description: When the third party's article was created.
        remote_updated_at:
          type:
            - string
            - 'null'
          format: date-time
          description: When the third party's article was updated.
        parent_article:
          type:
            - string
            - 'null'
          format: uuid
          description: The parent article an article is nested within.
        parent_container:
          type:
            - string
            - 'null'
          format: uuid
          description: The parent container an article is nested within.
        root_container:
          type:
            - string
            - 'null'
          format: uuid
          description: >-
            The top-level container in the hierarchy that holds this article.
            This will reference a container object that will typically be a
            SPACE or WORKSPACE type.
        permissions:
          type: array
          items:
            $ref: '#/components/schemas/Permission'
        attachments:
          type: array
          items:
            type: string
            format: uuid
        remote_was_deleted:
          type: boolean
          description: >-
            Indicates whether or not this object has been deleted in the third
            party platform. Full coverage deletion detection is a premium
            add-on. Native deletion detection is offered for free with limited
            coverage. [Learn
            more](https://docs.merge.dev/integrations/hris/supported-features/).
        field_mappings:
          oneOf:
            - $ref: '#/components/schemas/ArticleFieldMappings'
            - type: 'null'
        remote_data:
          type:
            - array
            - 'null'
          items:
            $ref: '#/components/schemas/RemoteData'
      title: Article
```