> ## 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.

# File Channels

> A channel where files can be shared across clients and companies, with membership scoped to individuals, groups, or companies.

This resource represents a channel where [Files](/docs/api-reference/resources/files) can be shared across [Clients](/docs/api-reference/resources/clients) and [Companies](/docs/api-reference/resources/companies). Items associated with a channel are only accessible to the members of that channel. The members of the channel are users in a workspace including both clients and internal users.

Based on the `membershipType` of a file channel, the client members are either pre-determined or fluid. An `individual` file channel has a single client; a `company` file channel has all clients associated with the corresponding company.

On the other hand, a `group` file channel has a fluid list of clients within a company (it could potentially have one, several, or even all clients within the company). The members of a `group` file channel can be added or removed via the UI.

The `clientId` and `companyId` properties allow you to easily identify the source entity for that file channel (without having to e.g. search through the `memberIds`). Only individual channels will have a `clientId`. The `companyId` for individual channels indicates which company of the client this channel belongs to.

## Properties

**id** `string`
The unique identifier for this item. **Note:** Not all `id` properties will be in UUID format.

**createdAt** `string`
The date this item was created in RFC3339 format.

**updatedAt** `string`
The date this item was updated in RFC3339 format.

**object** `string`
The object type of this resource.

**clientId** `string`

The client this file channel belongs to. This is only set for channels when `membershipType` is `individual`.

**companyId** `string`

Which company this file channel belongs to.

**membershipType** `string`
The type of membership that this channel is associated with. Can be one of `individual`, `group` or `company`.

| Value        | Description                                                                                                                                                                                                                                      |
| ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `individual` | This channel contains a single client user.                                                                                                                                                                                                      |
| `group`      | This channel contains multiple client users. All clients users in a group must belong to the same company.                                                                                                                                       |
| `company`    | This channel contains all clients that are associated with a company. When a client is assigned to a company, they will be added to this channel. When a client is deleted or unassigned from a company, they will be removed from this channel. |

~~**membershipEntityId** `string`~~

Deprecated. Use clientId and companyId instead.

**memberIds** `array of strings`
The user IDs associated with this particular channel. These will always be UUIDs of the members of the channel, including clients and internal users.

```json Example File Channel Object theme={null}
{
  "id": "us-east-1_JDwzcwQiA/339b6252-d773-4c58-a5ef-236ac3edc566",
  "object": "fileChannel",
  "createdAt": "2022-08-07T15:04:23Z",
  "updatedAt": "2022-08-07T15:12:05Z",
  "membershipType": "individual",
  "membershipEntityId": "a6fcd58b-fc40-46e1-ab49-219ec8162a6b",
  "clientId": "a6fcd58b-fc40-46e1-ab49-219ec8162a6b",
  "companyId": "04a818c2-d035-495c-9cc2-06a11a8b91f6",
  "memberIds": [
    "a6fcd58b-fc40-46e1-ab49-219ec8162a6b"
  ]
}
```