# GraphQL operations

Operations on content in GraphQL are performed by using [mutations](https://graphql.org/learn/mutations/). They include creating, updating, and deleting content items.

The schema contains two mutations per content type, for example, `createFolder`, and `updateFolder`. You can also make use of the generic `deleteContent` and `uploadFiles` mutations.

## Creating content

Create a new Folder as a child of Location `2` with:

```
mutation createFolder {
  createFolder(
    language: eng_GB
    parentLocationId: 2
    input: {
      name: "New Folder"
    }
  ) {
    id
  }
}
```

Response:

```
{
  "data": {
    "createFolder": {
      "id": "RG9tYWluQ29udGVudDo2NA=="
    }
  }
}
```

## Updating content

Modify the name of a Folder content item with:

```
mutation updateFolder {
  updateFolder(
    language: eng_GB
    contentId: 64
    input: {
      name: "New Folder name"
    }
  ) {
    id
  }
}
```

Response:

```
{
  "data": {
    "updateFolder": {
      "id": "RG9tYWluQ29udGVudDo2NA=="
    }
  }
}
```

The input for updating a content item is the same as when creating it, but all fields are optional.

## Deleting content

You can delete any content item by providing its `contentId` (or its GraphQL opaque ID under `id`):

```
mutation deleteBlogPost {
  deleteContent(contentId: 64) {
    id
    contentId
  }
}
```

Response:

```
{
  "data": {
    "deleteContent": {
      "id": "Rm9sZGVyQ29udGVudDo2NA==",
      "contentId": 64
    }
  }
}
```

## File upload

Note

Uploading binary files isn't possible through GraphiQL. You can use alternative third-party clients such as [Altair GraphQL](https://altairgraphql.dev/).

Uploading files makes use of dedicated mutations per content type, for example:

```
mutation CreateImage($file: FileUpload!) {
  createImage(
    parentLocationId: 51,
    language: eng_GB,
    input: {
      name: "An image created over GraphQL",
      image: {
        alternativeText: "The alternative text",
        file: $file
      }
    }
  ) {
    _info { id mainLocationId }
    name
    image { fileName alternativeText uri }
  }
}
```

The file is provided as the `$file` variable, defined as an `UploadFile`.

You can include this mutation in a cURL request under `operations`:

```
curl -v -X POST \
  <yourdomain>/graphql \
  -H "Cookie: $AUTH_COOKIE" \
  -F 'operations={"query":"mutation createFile($file: FileUpload!) { ... }","variables":{"file": null}}' \
  -F 'map={"image":["variables.file"]}' \
  -F "image"=@/path/to/image.png
```

For example:

```
curl -v -X POST \
  <yourdomain>/graphql \
  -H "Cookie: $AUTH_COOKIE" \
  -F 'operations={"query":"mutation CreateImage($file: FileUpload!) { createImage( parentLocationId: 51, input: { name: \"An image created over GraphQL\", image: { alternativeText: \"The alternative text\", file: $file } }, language: \"eng-GB\" ) { _info { id mainLocationId } _url name image { fileName alternativeText uri } } }","variables":{"file": null}}' \
  -F 'map={"image":["variables.file"]}' \
  -F "image"=@/path/to/image.png
```

Authentication

The example above requires you to set your authentication cookie in the `$AUTH_COOKIE` variable. For more information, see [Authentication](https://doc.ibexa.co/en/latest/api/graphql/graphql/#authentication).

### Uploading multiple files

You can upload multiple files with one operation in a similar way by using the `uploadFiles` mutation. Here the files are provided in a `$files` variable and listed under `map` in the cURL request.

```
mutation UploadMultipleFiles($files: [FileUpload]!) {
  uploadFiles(
    locationId: 51,
    files: $files,
    language: eng_GB
  ) {
    files {
      _url
      _location {
        id
      }
      ... on ImageContent {
        name
        image {
          uri
        }
      }
      ... on FileContent {
        name
        file {
          uri
        }
      }
      ... on VideoContent {
        name
        file {
          uri
        }
      }
    }
    warnings
  }
}
```

Include this mutation in a cURL request:

```
curl -v -X POST \
  <yourdomain>/graphql \
  -H 'Cookie: $AUTH_COOKIE' \
  -F 'operations={"query": "mutation UploadMultipleFiles($files: [FileUpload]!) { uploadFiles( locationId: 51, files: $files, languageCode: \"eng-GB\" ) { files { _url _location { id } ... on ImageContent { name image { uri } } ... on FileContent { name file { uri } } ... on VideoContent { name file { uri } } } warnings } }", "variables": {"files": [null, null, null, null, null]}}' \
  -F 'map={"image1":["variables.files.0"], "image2":["variables.files.1"], "file1":["variables.files.2"], "file2":["variables.files.3"], "media":["variables.files.4"]}' \
  -F "image1"=@/tmp/files/image1.png \
  -F "image2"=@/tmp/files/image2.png \
  -F "file1"=@/tmp/files/file1.pdf \
  -F "file2"=@/tmp/files/file2.zip \
  -F "media"=@/tmp/files/media.mp4
```