> 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 Container object is used to represent a grouping of articles in the knowledge base. This can include Spaces, Folders, Databases, etc.

### The Container Object

```json
{
  "id": "string",
  "remote_id": "string",
  "created_at": "2023-01-01T00:00:00Z",
  "modified_at": "2023-01-01T00:00:00Z",
  "name": "string",
  "description": "string",
  "status": "DRAFT",
  "container_url": "string",
  "type": "FOLDER",
  "visibility": "PUBLIC",
  "remote_created_at": "2023-01-01T00:00:00Z",
  "remote_updated_at": "2023-01-01T00:00:00Z",
  "parent_article": "string",
  "parent_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": {}
    }
  ],
  "remote_was_deleted": true,
  "field_mappings": {},
  "remote_data": [
    {
      "path": "string",
      "data": {}
    }
  ]
}
```

### Schema (`Container`)

```yaml
components:
  schemas:
    Status3c6Enum:
      type: string
      enum:
        - DRAFT
        - PUBLISHED
        - ARCHIVED
        - TRASH
      description: |-
        * `DRAFT` - DRAFT
        * `PUBLISHED` - PUBLISHED
        * `ARCHIVED` - ARCHIVED
        * `TRASH` - TRASH
      title: Status3c6Enum
    ContainerTypeEnum:
      type: string
      enum:
        - FOLDER
        - SPACE
        - COLLECTION
        - SECTION
        - CATEGORY
        - DATABASE
      description: |-
        * `FOLDER` - FOLDER
        * `SPACE` - SPACE
        * `COLLECTION` - COLLECTION
        * `SECTION` - SECTION
        * `CATEGORY` - CATEGORY
        * `DATABASE` - DATABASE
      title: ContainerTypeEnum
    VisibilityEnum:
      type: string
      enum:
        - PUBLIC
        - INTERNAL
        - RESTRICTED
      description: |-
        * `PUBLIC` - PUBLIC
        * `INTERNAL` - INTERNAL
        * `RESTRICTED` - RESTRICTED
      title: VisibilityEnum
    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
    ContainerFieldMappings:
      type: object
      properties: {}
      title: ContainerFieldMappings
    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
    Container:
      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.
        name:
          type:
            - string
            - 'null'
          maxLength: 254
          description: Name of the container.
        description:
          type:
            - string
            - 'null'
          maxLength: 2000
          description: Description of the container.
        status:
          oneOf:
            - $ref: '#/components/schemas/Status3c6Enum'
            - type: 'null'
          description: |-
            The container's status.

            * `DRAFT` - DRAFT
            * `PUBLISHED` - PUBLISHED
            * `ARCHIVED` - ARCHIVED
            * `TRASH` - TRASH
        container_url:
          type:
            - string
            - 'null'
          maxLength: 2000
          description: The URL to the webpage of the container.
        type:
          oneOf:
            - $ref: '#/components/schemas/ContainerTypeEnum'
            - type: 'null'
          description: |-
            The container's type.

            * `FOLDER` - FOLDER
            * `SPACE` - SPACE
            * `COLLECTION` - COLLECTION
            * `SECTION` - SECTION
            * `CATEGORY` - CATEGORY
            * `DATABASE` - DATABASE
        visibility:
          oneOf:
            - $ref: '#/components/schemas/VisibilityEnum'
            - type: 'null'
          description: |-
            The container's visibility.

            * `PUBLIC` - PUBLIC
            * `INTERNAL` - INTERNAL
            * `RESTRICTED` - RESTRICTED
        remote_created_at:
          type:
            - string
            - 'null'
          format: date-time
          description: When the third party's container was created.
        remote_updated_at:
          type:
            - string
            - 'null'
          format: date-time
          description: When the third party's container was updated.
        parent_article:
          type:
            - string
            - 'null'
          format: uuid
          description: The parent article a container is nested within.
        parent_container:
          type:
            - string
            - 'null'
          format: uuid
          description: The parent container a container is nested within.
        permissions:
          type: array
          items:
            $ref: '#/components/schemas/Permission'
        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/ContainerFieldMappings'
            - type: 'null'
        remote_data:
          type:
            - array
            - 'null'
          items:
            $ref: '#/components/schemas/RemoteData'
      title: Container
```