---
canonical: https://amplience.com/developers/docs/apis/asset-management/reference/mutations/content-generation/
title: "Mutations: Content generation"
description: GraphQL mutations for content generation sessions, jobs, flows, and content review in the Amplience GraphQL Management API.
audience: Developer
date_published: 2023-05-26
date_modified: 2026-07-20
---

# Mutations: Content generation

GraphQL mutations for content generation sessions, jobs, flows, and content review in the Amplience GraphQL Management API.

## Sessions & messages

### createContentGenerationSession

```graphql
createContentGenerationSession(
  input: CreateContentGenerationSessionInput!
): ContentGenerationSession!
```

**Returns:** [ContentGenerationSession](https://amplience.com/developers/docs/apis/asset-management/reference/objects/content-generation#contentgenerationsession)!

**Arguments:**

| Argument | Type | Default | Description |
|---|---|---|---|
| `input` | [CreateContentGenerationSessionInput](https://amplience.com/developers/docs/apis/asset-management/reference/inputs/content-generation#createcontentgenerationsessioninput)! |  |  |

### updateContentGenerationSession

```graphql
updateContentGenerationSession(
  input: UpdateContentGenerationSessionInput!
): ContentGenerationSession!
```

**Returns:** [ContentGenerationSession](https://amplience.com/developers/docs/apis/asset-management/reference/objects/content-generation#contentgenerationsession)!

**Arguments:**

| Argument | Type | Default | Description |
|---|---|---|---|
| `input` | [UpdateContentGenerationSessionInput](https://amplience.com/developers/docs/apis/asset-management/reference/inputs/content-generation#updatecontentgenerationsessioninput)! |  |  |

### deleteContentGenerationSession

```graphql
deleteContentGenerationSession(
  input: DeleteContentGenerationSessionInput!
): Boolean!
```

**Returns:** `Boolean`!

**Arguments:**

| Argument | Type | Default | Description |
|---|---|---|---|
| `input` | [DeleteContentGenerationSessionInput](https://amplience.com/developers/docs/apis/asset-management/reference/inputs/content-generation#deletecontentgenerationsessioninput)! |  |  |

### submitContentGenerationSessionMessage

**This mutation uses Amplience Credits.**

Submits a message to a Content Studio session. Returns the details of the submitted message
and a URL to stream the LLM response from, ideal for user facing front ends.

Consumes Amplience credits.

Labs preview.

**See also:** [Mutations that use Amplience Credits](https://amplience.com/developers/docs/apis/asset-management/overview/mutation-credit-usage/)

```graphql
submitContentGenerationSessionMessage(
  input: SubmitContentGenerationSessionMessageInput!
): SubmitContentGenerationSessionMessageResponse!
```

**Returns:** [SubmitContentGenerationSessionMessageResponse](https://amplience.com/developers/docs/apis/asset-management/reference/objects/content-generation#submitcontentgenerationsessionmessageresponse)!

**Arguments:**

| Argument | Type | Default | Description |
|---|---|---|---|
| `input` | [SubmitContentGenerationSessionMessageInput](https://amplience.com/developers/docs/apis/asset-management/reference/inputs/content-generation#submitcontentgenerationsessionmessageinput)! |  |  |

### scoreContentGenerationSessionMessage

```graphql
scoreContentGenerationSessionMessage(
  input: ScoreContentGenerationSessionMessageInput!
): ContentGenerationSessionMessage!
```

**Returns:** [ContentGenerationSessionMessage](https://amplience.com/developers/docs/apis/asset-management/reference/objects/content-generation#contentgenerationsessionmessage)!

**Arguments:**

| Argument | Type | Default | Description |
|---|---|---|---|
| `input` | [ScoreContentGenerationSessionMessageInput](https://amplience.com/developers/docs/apis/asset-management/reference/inputs/content-generation#scorecontentgenerationsessionmessageinput)! |  |  |

### generateEditForContentGenerationSessionMessageProperty

**This mutation uses Amplience Credits.**

Submits a request to edit a selection of text.
Returns a URL to stream the LLM response from.

Consumes Amplience credits.

Labs preview.

**See also:** [Mutations that use Amplience Credits](https://amplience.com/developers/docs/apis/asset-management/overview/mutation-credit-usage/)

```graphql
generateEditForContentGenerationSessionMessageProperty(
  input: GenerateEditForContentGenerationSessionMessagePropertyInput!
): GenerateEditForContentGenerationSessionMessagePropertyResponse!
```

**Returns:** [GenerateEditForContentGenerationSessionMessagePropertyResponse](https://amplience.com/developers/docs/apis/asset-management/reference/objects/content-generation#generateeditforcontentgenerationsessionmessagepropertyresponse)!

**Arguments:**

| Argument | Type | Default | Description |
|---|---|---|---|
| `input` | [GenerateEditForContentGenerationSessionMessagePropertyInput](https://amplience.com/developers/docs/apis/asset-management/reference/inputs/content-generation#generateeditforcontentgenerationsessionmessagepropertyinput)! |  |  |

### saveContentGenerationSessionMessageTextProperty

```graphql
saveContentGenerationSessionMessageTextProperty(
  input: SaveContentGenerationSessionMessageTextPropertyInput!
): Boolean!
```

**Returns:** `Boolean`!

**Arguments:**

| Argument | Type | Default | Description |
|---|---|---|---|
| `input` | [SaveContentGenerationSessionMessageTextPropertyInput](https://amplience.com/developers/docs/apis/asset-management/reference/inputs/content-generation#savecontentgenerationsessionmessagetextpropertyinput)! |  |  |

## Briefs & templates

### createContentGenerationBriefTemplate

```graphql
createContentGenerationBriefTemplate(
  input: CreateContentGenerationBriefTemplateInput!
): ContentGenerationBriefTemplate!
```

**Returns:** [ContentGenerationBriefTemplate](https://amplience.com/developers/docs/apis/asset-management/reference/objects/content-generation#contentgenerationbrieftemplate)!

**Arguments:**

| Argument | Type | Default | Description |
|---|---|---|---|
| `input` | [CreateContentGenerationBriefTemplateInput](https://amplience.com/developers/docs/apis/asset-management/reference/inputs/content-generation#createcontentgenerationbrieftemplateinput)! |  |  |

### updateContentGenerationBriefTemplate

```graphql
updateContentGenerationBriefTemplate(
  input: UpdateContentGenerationBriefTemplateInput!
): ContentGenerationBriefTemplate!
```

**Returns:** [ContentGenerationBriefTemplate](https://amplience.com/developers/docs/apis/asset-management/reference/objects/content-generation#contentgenerationbrieftemplate)!

**Arguments:**

| Argument | Type | Default | Description |
|---|---|---|---|
| `input` | [UpdateContentGenerationBriefTemplateInput](https://amplience.com/developers/docs/apis/asset-management/reference/inputs/content-generation#updatecontentgenerationbrieftemplateinput)! |  |  |

### deleteContentGenerationBriefTemplate

```graphql
deleteContentGenerationBriefTemplate(
  input: DeleteContentGenerationBriefTemplateInput!
): Boolean!
```

**Returns:** `Boolean`!

**Arguments:**

| Argument | Type | Default | Description |
|---|---|---|---|
| `input` | [DeleteContentGenerationBriefTemplateInput](https://amplience.com/developers/docs/apis/asset-management/reference/inputs/content-generation#deletecontentgenerationbrieftemplateinput)! |  |  |

## Audiences, brand voices & tones

### createContentGenerationAudience

```graphql
createContentGenerationAudience(
  input: CreateContentGenerationAudienceInput!
): ContentGenerationAudience!
```

**Returns:** [ContentGenerationAudience](https://amplience.com/developers/docs/apis/asset-management/reference/objects/content-generation#contentgenerationaudience)!

**Arguments:**

| Argument | Type | Default | Description |
|---|---|---|---|
| `input` | [CreateContentGenerationAudienceInput](https://amplience.com/developers/docs/apis/asset-management/reference/inputs/content-generation#createcontentgenerationaudienceinput)! |  |  |

### updateContentGenerationAudience

```graphql
updateContentGenerationAudience(
  input: UpdateContentGenerationAudienceInput!
): ContentGenerationAudience!
```

**Returns:** [ContentGenerationAudience](https://amplience.com/developers/docs/apis/asset-management/reference/objects/content-generation#contentgenerationaudience)!

**Arguments:**

| Argument | Type | Default | Description |
|---|---|---|---|
| `input` | [UpdateContentGenerationAudienceInput](https://amplience.com/developers/docs/apis/asset-management/reference/inputs/content-generation#updatecontentgenerationaudienceinput)! |  |  |

### deleteContentGenerationAudience

```graphql
deleteContentGenerationAudience(
  input: DeleteContentGenerationAudienceInput!
): Boolean!
```

**Returns:** `Boolean`!

**Arguments:**

| Argument | Type | Default | Description |
|---|---|---|---|
| `input` | [DeleteContentGenerationAudienceInput](https://amplience.com/developers/docs/apis/asset-management/reference/inputs/content-generation#deletecontentgenerationaudienceinput)! |  |  |

### createContentGenerationBrandVoice

```graphql
createContentGenerationBrandVoice(
  input: CreateContentGenerationBrandVoiceInput!
): ContentGenerationBrandVoice!
```

**Returns:** [ContentGenerationBrandVoice](https://amplience.com/developers/docs/apis/asset-management/reference/objects/content-generation#contentgenerationbrandvoice)!

**Arguments:**

| Argument | Type | Default | Description |
|---|---|---|---|
| `input` | [CreateContentGenerationBrandVoiceInput](https://amplience.com/developers/docs/apis/asset-management/reference/inputs/content-generation#createcontentgenerationbrandvoiceinput)! |  |  |

### updateContentGenerationBrandVoice

```graphql
updateContentGenerationBrandVoice(
  input: UpdateContentGenerationBrandVoiceInput!
): ContentGenerationBrandVoice!
```

**Returns:** [ContentGenerationBrandVoice](https://amplience.com/developers/docs/apis/asset-management/reference/objects/content-generation#contentgenerationbrandvoice)!

**Arguments:**

| Argument | Type | Default | Description |
|---|---|---|---|
| `input` | [UpdateContentGenerationBrandVoiceInput](https://amplience.com/developers/docs/apis/asset-management/reference/inputs/content-generation#updatecontentgenerationbrandvoiceinput)! |  |  |

### deleteContentGenerationBrandVoice

```graphql
deleteContentGenerationBrandVoice(
  input: DeleteContentGenerationBrandVoiceInput!
): Boolean!
```

**Returns:** `Boolean`!

**Arguments:**

| Argument | Type | Default | Description |
|---|---|---|---|
| `input` | [DeleteContentGenerationBrandVoiceInput](https://amplience.com/developers/docs/apis/asset-management/reference/inputs/content-generation#deletecontentgenerationbrandvoiceinput)! |  |  |

### createContentGenerationTone

```graphql
createContentGenerationTone(
  input: CreateContentGenerationToneInput!
): ContentGenerationTone!
```

**Returns:** [ContentGenerationTone](https://amplience.com/developers/docs/apis/asset-management/reference/objects/content-generation#contentgenerationtone)!

**Arguments:**

| Argument | Type | Default | Description |
|---|---|---|---|
| `input` | [CreateContentGenerationToneInput](https://amplience.com/developers/docs/apis/asset-management/reference/inputs/content-generation#createcontentgenerationtoneinput)! |  |  |

### updateContentGenerationTone

```graphql
updateContentGenerationTone(
  input: UpdateContentGenerationToneInput!
): ContentGenerationTone!
```

**Returns:** [ContentGenerationTone](https://amplience.com/developers/docs/apis/asset-management/reference/objects/content-generation#contentgenerationtone)!

**Arguments:**

| Argument | Type | Default | Description |
|---|---|---|---|
| `input` | [UpdateContentGenerationToneInput](https://amplience.com/developers/docs/apis/asset-management/reference/inputs/content-generation#updatecontentgenerationtoneinput)! |  |  |

### deleteContentGenerationTone

```graphql
deleteContentGenerationTone(
  input: DeleteContentGenerationToneInput!
): Boolean!
```

**Returns:** `Boolean`!

**Arguments:**

| Argument | Type | Default | Description |
|---|---|---|---|
| `input` | [DeleteContentGenerationToneInput](https://amplience.com/developers/docs/apis/asset-management/reference/inputs/content-generation#deletecontentgenerationtoneinput)! |  |  |

## Examples

### createContentGenerationExample

```graphql
createContentGenerationExample(
  input: CreateContentGenerationExampleInput!
): ContentGenerationExample!
```

**Returns:** [ContentGenerationExample](https://amplience.com/developers/docs/apis/asset-management/reference/objects/content-generation#contentgenerationexample)!

**Arguments:**

| Argument | Type | Default | Description |
|---|---|---|---|
| `input` | [CreateContentGenerationExampleInput](https://amplience.com/developers/docs/apis/asset-management/reference/inputs/content-generation#createcontentgenerationexampleinput)! |  |  |

### updateContentGenerationExample

```graphql
updateContentGenerationExample(
  input: UpdateContentGenerationExampleInput!
): ContentGenerationExample!
```

**Returns:** [ContentGenerationExample](https://amplience.com/developers/docs/apis/asset-management/reference/objects/content-generation#contentgenerationexample)!

**Arguments:**

| Argument | Type | Default | Description |
|---|---|---|---|
| `input` | [UpdateContentGenerationExampleInput](https://amplience.com/developers/docs/apis/asset-management/reference/inputs/content-generation#updatecontentgenerationexampleinput)! |  |  |

### deleteContentGenerationExample

```graphql
deleteContentGenerationExample(
  input: DeleteContentGenerationExampleInput!
): Boolean!
```

**Returns:** `Boolean`!

**Arguments:**

| Argument | Type | Default | Description |
|---|---|---|---|
| `input` | [DeleteContentGenerationExampleInput](https://amplience.com/developers/docs/apis/asset-management/reference/inputs/content-generation#deletecontentgenerationexampleinput)! |  |  |

### createContentGenerationExampleFolder

```graphql
createContentGenerationExampleFolder(
  input: CreateContentGenerationExampleFolderInput!
): ContentGenerationExampleFolder!
```

**Returns:** [ContentGenerationExampleFolder](https://amplience.com/developers/docs/apis/asset-management/reference/objects/content-generation#contentgenerationexamplefolder)!

**Arguments:**

| Argument | Type | Default | Description |
|---|---|---|---|
| `input` | [CreateContentGenerationExampleFolderInput](https://amplience.com/developers/docs/apis/asset-management/reference/inputs/content-generation#createcontentgenerationexamplefolderinput)! |  |  |

### updateContentGenerationExampleFolder

```graphql
updateContentGenerationExampleFolder(
  input: UpdateContentGenerationExampleFolderInput!
): ContentGenerationExampleFolder!
```

**Returns:** [ContentGenerationExampleFolder](https://amplience.com/developers/docs/apis/asset-management/reference/objects/content-generation#contentgenerationexamplefolder)!

**Arguments:**

| Argument | Type | Default | Description |
|---|---|---|---|
| `input` | [UpdateContentGenerationExampleFolderInput](https://amplience.com/developers/docs/apis/asset-management/reference/inputs/content-generation#updatecontentgenerationexamplefolderinput)! |  |  |

### deleteContentGenerationExampleFolder

```graphql
deleteContentGenerationExampleFolder(
  input: DeleteContentGenerationExampleFolderInput!
): Boolean!
```

**Returns:** `Boolean`!

**Arguments:**

| Argument | Type | Default | Description |
|---|---|---|---|
| `input` | [DeleteContentGenerationExampleFolderInput](https://amplience.com/developers/docs/apis/asset-management/reference/inputs/content-generation#deletecontentgenerationexamplefolderinput)! |  |  |

## Jobs & models

### submitContentGenerationJob

**This mutation uses Amplience Credits.**

Submits a content generation job and returns the details of the submitted job.
Full LLM text response retrievable without streaming, by accessing the job.

Best for programmatic access to an LLM.

Consumes Amplience credits.

Labs preview.

**See also:** [Mutations that use Amplience Credits](https://amplience.com/developers/docs/apis/asset-management/overview/mutation-credit-usage/)

```graphql
submitContentGenerationJob(
  input: SubmitContentGenerationJobInput!
): ContentGenerationJob!
```

**Returns:** [ContentGenerationJob](https://amplience.com/developers/docs/apis/asset-management/reference/objects/content-generation#contentgenerationjob)!

**Arguments:**

| Argument | Type | Default | Description |
|---|---|---|---|
| `input` | [SubmitContentGenerationJobInput](https://amplience.com/developers/docs/apis/asset-management/reference/inputs/content-generation#submitcontentgenerationjobinput)! |  |  |

### enableContentGenerationModel

```graphql
enableContentGenerationModel(
  input: EnableContentGenerationModelInput!
): Boolean!
```

**Returns:** `Boolean`!

**Arguments:**

| Argument | Type | Default | Description |
|---|---|---|---|
| `input` | [EnableContentGenerationModelInput](https://amplience.com/developers/docs/apis/asset-management/reference/inputs/content-generation#enablecontentgenerationmodelinput)! |  |  |

### disableContentGenerationModel

```graphql
disableContentGenerationModel(
  input: DisableContentGenerationModelInput!
): Boolean!
```

**Returns:** `Boolean`!

**Arguments:**

| Argument | Type | Default | Description |
|---|---|---|---|
| `input` | [DisableContentGenerationModelInput](https://amplience.com/developers/docs/apis/asset-management/reference/inputs/content-generation#disablecontentgenerationmodelinput)! |  |  |

## Text & SEO generation

### generateRichText

**This mutation uses Amplience Credits.**

**See also:** [Mutations that use Amplience Credits](https://amplience.com/developers/docs/apis/asset-management/overview/mutation-credit-usage/)

```graphql
generateRichText(
  input: RichTextGenerationInput!
): RichTextGenerationTicket
```

**Returns:** [RichTextGenerationTicket](https://amplience.com/developers/docs/apis/asset-management/reference/objects/content-generation#richtextgenerationticket)

**Arguments:**

| Argument | Type | Default | Description |
|---|---|---|---|
| `input` | [RichTextGenerationInput](https://amplience.com/developers/docs/apis/asset-management/reference/inputs/content-generation#richtextgenerationinput)! |  |  |

### generateSEOText

**This mutation uses Amplience Credits.**

**See also:** [Mutations that use Amplience Credits](https://amplience.com/developers/docs/apis/asset-management/overview/mutation-credit-usage/)

```graphql
generateSEOText(
  input: SEOGenerationInput!
): SEOGenerationResponse
```

**Returns:** [SEOGenerationResponse](https://amplience.com/developers/docs/apis/asset-management/reference/objects/content-generation#seogenerationresponse)

**Arguments:**

| Argument | Type | Default | Description |
|---|---|---|---|
| `input` | [SEOGenerationInput](https://amplience.com/developers/docs/apis/asset-management/reference/inputs/content-generation#seogenerationinput)! |  |  |

## Content review

### submitContentReview

```graphql
submitContentReview(
  input: SubmitContentReviewInput!
): SubmitContentReviewResponse!
```

**Returns:** [SubmitContentReviewResponse](https://amplience.com/developers/docs/apis/asset-management/reference/objects/content-generation#submitcontentreviewresponse)!

**Arguments:**

| Argument | Type | Default | Description |
|---|---|---|---|
| `input` | [SubmitContentReviewInput](https://amplience.com/developers/docs/apis/asset-management/reference/inputs/content-generation#submitcontentreviewinput)! |  |  |

## Content flow

### createContentFlow

```graphql
createContentFlow(
  input: CreateContentFlowInput!
): ContentFlow!
```

**Returns:** [ContentFlow](https://amplience.com/developers/docs/apis/asset-management/reference/objects/content-generation#contentflow)!

**Arguments:**

| Argument | Type | Default | Description |
|---|---|---|---|
| `input` | [CreateContentFlowInput](https://amplience.com/developers/docs/apis/asset-management/reference/inputs/content-generation#createcontentflowinput)! |  |  |

### updateContentFlow

```graphql
updateContentFlow(
  input: UpdateContentFlowInput!
): ContentFlow!
```

**Returns:** [ContentFlow](https://amplience.com/developers/docs/apis/asset-management/reference/objects/content-generation#contentflow)!

**Arguments:**

| Argument | Type | Default | Description |
|---|---|---|---|
| `input` | [UpdateContentFlowInput](https://amplience.com/developers/docs/apis/asset-management/reference/inputs/content-generation#updatecontentflowinput)! |  |  |

### deleteContentFlow

```graphql
deleteContentFlow(
  input: DeleteContentFlowInput!
): Boolean!
```

**Returns:** `Boolean`!

**Arguments:**

| Argument | Type | Default | Description |
|---|---|---|---|
| `input` | [DeleteContentFlowInput](https://amplience.com/developers/docs/apis/asset-management/reference/inputs/content-generation#deletecontentflowinput)! |  |  |

### runContentFlow

```graphql
runContentFlow(
  input: RunContentFlowInput!
): String!
```

**Returns:** `String`!

**Arguments:**

| Argument | Type | Default | Description |
|---|---|---|---|
| `input` | [RunContentFlowInput](https://amplience.com/developers/docs/apis/asset-management/reference/inputs/content-generation#runcontentflowinput)! |  |  |

### testContentFlow

```graphql
testContentFlow(
  input: RunContentFlowInput!
): String!
```

**Returns:** `String`!

**Arguments:**

| Argument | Type | Default | Description |
|---|---|---|---|
| `input` | [RunContentFlowInput](https://amplience.com/developers/docs/apis/asset-management/reference/inputs/content-generation#runcontentflowinput)! |  |  |

### cancelContentFlowRun

```graphql
cancelContentFlowRun(
  input: CancelContentFlowRunInput!
): Boolean!
```

**Returns:** `Boolean`!

**Arguments:**

| Argument | Type | Default | Description |
|---|---|---|---|
| `input` | [CancelContentFlowRunInput](https://amplience.com/developers/docs/apis/asset-management/reference/inputs/content-generation#cancelcontentflowruninput)! |  |  |

### setContentFlowStatus

```graphql
setContentFlowStatus(
  input: SetContentFlowStatusInput!
): Boolean!
```

**Returns:** `Boolean`!

**Arguments:**

| Argument | Type | Default | Description |
|---|---|---|---|
| `input` | [SetContentFlowStatusInput](https://amplience.com/developers/docs/apis/asset-management/reference/inputs/content-generation#setcontentflowstatusinput)! |  |  |