# createContentView

Mutation

Create a saved content (media deck) view for the current workspace.

Available to agents as MCP tool `createContentView` — see [Write tools](/api/v2/docs/mcp/write-tools#create-content-view).

## Arguments

| Name | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `input` | [`CreateContentViewInput!`](/api/v2/docs/types/create-content-view-input) | Yes | — | Mutation input. |

## Returns

| Name | Type | Description |
| --- | --- | --- |
| `contentView` | [`ContentView`](/api/v2/docs/types/content-view) | The newly created content view. Null on validation failure. |
| `userErrors` | [`[UserError!]!`](/api/v2/docs/types/user-error) | List of user-facing validation errors. Empty on success. |

## Examples

### Create a content view

Create a saved media-deck view for the workspace.

```graphql
mutation CreateContentViewDefault($input: CreateContentViewInput!) {
  createContentView(input: $input) {
    contentView {
      id
      name
      filters
    }
    userErrors {
      field
      message
    }
  }
}
```

Variables:

```json
{
  "input": {
    "name": "Top Reels",
    "filters": {
      "itemTypes": [
        "reel"
      ]
    }
  }
}
```

Response — HTTP 200:

```json
{
  "data": {
    "createContentView": {
      "contentView": {
        "id": "30510185-4eb4-5606-9833-1b79da53ffdc",
        "name": "Top Reels",
        "filters": {
          "itemTypes": [
            "reel"
          ]
        }
      },
      "userErrors": []
    }
  }
}
```
