> ## Documentation Index
> Fetch the complete documentation index at: https://studio.assembly.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Create File Channel

> Creates a file channel. Provide companyId for a company channel, clientId for an individual channel, or membershipType=group with memberIds. The legacy membershipEntityId/membershipType pair is still accepted.



## OpenAPI

````yaml /api-reference/openapi.json post /v1/channels/files
openapi: 3.0.0
info:
  contact: {}
  title: Assembly API
  version: 0.0.1
servers:
  - url: https://api.assembly.com
security: []
paths:
  /v1/channels/files:
    post:
      tags:
        - File Channels
      summary: Create File Channel
      description: >-
        Creates a file channel. Provide companyId for a company channel,
        clientId for an individual channel, or membershipType=group with
        memberIds. The legacy membershipEntityId/membershipType pair is still
        accepted.
      operationId: create-file-channel
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/filechannel.CreateFileChannelInput'
        description: File channel to create
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/filechannels.FileChannel'
          description: OK
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/dispatcher.Error'
          description: Bad Request
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/dispatcher.Error'
          description: Unauthorized
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/dispatcher.Error'
          description: Internal Server Error
      security:
        - APIKeyHeader: []
components:
  schemas:
    filechannel.CreateFileChannelInput:
      properties:
        clientId:
          description: Client to create an individual channel for (new schema).
          example: a1b2c3d4-0000-0000-0000-000000000001
          format: uuid
          type: string
        companyId:
          description: Company to create a company-wide channel for (new schema).
          example: a1b2c3d4-0000-0000-0000-000000000002
          format: uuid
          type: string
        memberIds:
          description: >-
            Member ids for a group channel (new schema, used with
            membershipType=group).
          example:
            - a1b2c3d4-0000-0000-0000-000000000003
          items:
            type: string
          type: array
        membershipEntityId:
          description: >-
            Id of the entity (client or company) the channel is based on
            (deprecated legacy schema).
          example: a1b2c3d4-0000-0000-0000-000000000002
          format: uuid
          type: string
        membershipType:
          description: Channel grouping type.
          enum:
            - individual
            - company
            - group
          example: company
          type: string
      type: object
    filechannels.FileChannel:
      properties:
        clientId:
          description: >-
            Populated in the platform API only, these fields do not exist in the
            DB

            Client this channel belongs to (set when membershipType is
            individual).
          example: a1b2c3d4-0000-0000-0000-000000000001
          format: uuid
          type: string
        companyId:
          description: >-
            Company this channel belongs to (set when membershipType is
            company).
          example: a1b2c3d4-0000-0000-0000-000000000002
          format: uuid
          type: string
        createdAt:
          type: string
        creatorId:
          type: string
        data:
          type: string
        id:
          type: string
        identityId:
          type: string
        lastNotificationSenderId:
          description: Id of the member who triggered the most recent notification.
          example: a1b2c3d4-0000-0000-0000-000000000003
          format: uuid
          type: string
        lastNotificationTimestamp:
          description: |-
            Notification fields populated from Fields["lastNotification"]
            Timestamp of the most recent notification on the channel.
          example: '2024-01-15T09:30:00Z'
          format: date-time
          type: string
        memberIds:
          description: Ids of the channel members.
          example:
            - a1b2c3d4-0000-0000-0000-000000000003
          items:
            type: string
          type: array
        membershipEntityId:
          description: >-
            Id of the entity (client or company) the channel is based on
            (deprecated legacy field).
          example: a1b2c3d4-0000-0000-0000-000000000002
          format: uuid
          type: string
        membershipType:
          description: How the channel's members are grouped together.
          enum:
            - individual
            - company
            - group
          example: company
          type: string
        object:
          type: string
        previousAttributes:
          additionalProperties: true
          type: object
        ref:
          type: string
        rootClientPermissions:
          description: >-
            Default permission level granted to client members on the channel's
            root folder.
          enum:
            - read_write
            - read_only
          example: read_write
          type: string
        updatedAt:
          type: string
      type: object
    dispatcher.Error:
      properties:
        code:
          type: string
        data: {}
        message:
          type: string
      type: object
  securitySchemes:
    APIKeyHeader:
      in: header
      name: X-API-KEY
      type: apiKey

````