---
canonical: https://amplience.com/developers/docs/apis/asset-management/reference/inputs/content-generation/
title: "Inputs: Content generation"
description: GraphQL input types for content generation, content flow, content review, video transcoding, and AI image tools in the Amplience GraphQL Management API.
audience: Developer
date_published: 2023-05-26
date_modified: 2026-07-20
---

# Inputs: Content generation

GraphQL input types for content generation, content flow, content review, video transcoding, and AI image tools in the Amplience GraphQL Management API.

## Video transcoding

### VideoTranscodingProfileInput

| Field | Type | Default | Description |
|---|---|---|---|
| `id` | `ID`! |  | ID of the asset |
| `profileIds` | \[`ID`!\]! |  | Ids of the video profiles |

## AI image tools

### GenerateImagesFromTextInput

| Field | Type | Default | Description |
|---|---|---|---|
| `organizationId` | `ID`! |  |  |
| `model` | [GenerateImagesFromTextModel](https://amplience.com/developers/docs/apis/asset-management/reference/enums#generateimagesfromtextmodel) |  |  |
| `prompt` | `String`! |  |  |
| `size` | `String`! |  |  |
| `numberOfImages` | `Int` |  |  |

### MagicEraseImageJobInput

| Field | Type | Default | Description |
|---|---|---|---|
| `organizationId` | `ID`! |  |  |
| `imageUrl` | `String`! |  |  |
| `maskUrl` | `String`! |  |  |

### RemoveBackgroundFromImageInput

| Field | Type | Default | Description |
|---|---|---|---|
| `organizationId` | `ID`! |  | Organization ID |
| `imageUrl` | `String`! |  | Image URL |

### GenerateCaptionForImageInput

| Field | Type | Default | Description |
|---|---|---|---|
| `organizationId` | `ID`! |  |  |
| `imageUrl` | `String`! |  |  |
| `params` | `String` |  |  |

### FindPointsOfInterestInImageInput

| Field | Type | Default | Description |
|---|---|---|---|
| `organizationId` | `ID`! |  |  |
| `imageUrl` | `String`! |  |  |
| `thingsToFind` | \[`String`!\]! |  |  |

### PointsOfInterestInImageInput

| Field | Type | Default | Description |
|---|---|---|---|
| `organizationId` | `ID`! |  |  |
| `imageUrl` | `String`! |  |  |
| `hints` | \[`String`!\] |  |  |

## Content generation

### CreateContentGenerationAudienceInput

| Field | Type | Default | Description |
|---|---|---|---|
| `cmsHubId` | `String`! |  |  |
| `label` | `String`! |  |  |
| `ageRangeMin` | `Int`! |  |  |
| `ageRangeMax` | `Int`! |  |  |
| `gender` | `String`! |  |  |
| `description` | `String` |  |  |

### UpdateContentGenerationAudienceInput

| Field | Type | Default | Description |
|---|---|---|---|
| `id` | `ID`! |  |  |
| `label` | `String`! |  |  |
| `ageRangeMin` | `Int`! |  |  |
| `ageRangeMax` | `Int`! |  |  |
| `gender` | `String`! |  |  |
| `description` | `String` |  |  |

### DeleteContentGenerationAudienceInput

| Field | Type | Default | Description |
|---|---|---|---|
| `id` | `ID`! |  |  |

### CreateContentGenerationBrandVoiceInput

| Field | Type | Default | Description |
|---|---|---|---|
| `cmsHubId` | `String`! |  |  |
| `label` | `String`! |  |  |
| `brandName` | `String` |  |  |
| `locale` | [ContentGenerationBrandVoiceLocale](https://amplience.com/developers/docs/apis/asset-management/reference/enums#contentgenerationbrandvoicelocale)! |  |  |
| `tone` | `ID` |  |  |
| `brandValues` | \[[UpdateContentGenerationBrandVoiceValue](#updatecontentgenerationbrandvoicevalue)!\]! |  |  |
| `brandRuleExclusions` | \[`String`!\]! |  |  |
| `brandRuleSubstitutions` | \[[UpdateContentGenerationBrandVoiceRuleSubstitution](#updatecontentgenerationbrandvoicerulesubstitution)!\]! |  |  |

### UpdateContentGenerationBrandVoiceInput

| Field | Type | Default | Description |
|---|---|---|---|
| `id` | `ID`! |  |  |
| `label` | `String`! |  |  |
| `brandName` | `String` |  |  |
| `locale` | [ContentGenerationBrandVoiceLocale](https://amplience.com/developers/docs/apis/asset-management/reference/enums#contentgenerationbrandvoicelocale)! |  |  |
| `tone` | `ID` |  |  |
| `brandValues` | \[[UpdateContentGenerationBrandVoiceValue](#updatecontentgenerationbrandvoicevalue)!\]! |  |  |
| `brandRuleExclusions` | \[`String`!\]! |  |  |
| `brandRuleSubstitutions` | \[[UpdateContentGenerationBrandVoiceRuleSubstitution](#updatecontentgenerationbrandvoicerulesubstitution)!\]! |  |  |

### DeleteContentGenerationBrandVoiceInput

| Field | Type | Default | Description |
|---|---|---|---|
| `id` | `ID`! |  |  |

### UpdateContentGenerationBrandVoiceRuleSubstitution

| Field | Type | Default | Description |
|---|---|---|---|
| `term` | `String`! |  |  |
| `substitute` | `String`! |  |  |

### UpdateContentGenerationBrandVoiceValue

| Field | Type | Default | Description |
|---|---|---|---|
| `label` | `String`! |  |  |
| `description` | `String`! |  |  |

### CreateContentGenerationBriefTemplateInput

| Field | Type | Default | Description |
|---|---|---|---|
| `defaultModelId` | `String`! |  |  |
| `label` | `String`! |  |  |
| `description` | `String`! |  |  |
| `imageUrl` | `String` |  |  |
| `category` | `String`! |  |  |
| `cmsHubId` | `ID`! |  |  |
| `inputFields` | \[[ContentGenerationBriefTemplateFieldInput](#contentgenerationbrieftemplatefieldinput)!\]! |  |  |
| `instructions` | `String`! |  |  |

### UpdateContentGenerationBriefTemplateInput

| Field | Type | Default | Description |
|---|---|---|---|
| `defaultModelId` | `String` |  |  |
| `id` | `ID`! |  |  |
| `label` | `String` |  |  |
| `description` | `String` |  |  |
| `category` | `String` |  |  |
| `imageUrl` | `String` |  |  |
| `inputFields` | \[[ContentGenerationBriefTemplateFieldInput](#contentgenerationbrieftemplatefieldinput)!\] |  |  |
| `instructions` | `String` |  |  |

### DeleteContentGenerationBriefTemplateInput

| Field | Type | Default | Description |
|---|---|---|---|
| `id` | `ID`! |  |  |

### ContentGenerationBriefTemplateFieldInput

| Field | Type | Default | Description |
|---|---|---|---|
| `text` | [ContentGenerationBriefTemplateTextFieldInput](#contentgenerationbrieftemplatetextfieldinput) |  |  |
| `image` | [ContentGenerationBriefTemplateImageFieldInput](#contentgenerationbrieftemplateimagefieldinput) |  |  |
| `keyValue` | [ContentGenerationBriefTemplateKeyValueFieldInput](#contentgenerationbrieftemplatekeyvaluefieldinput) |  |  |

### ContentGenerationBriefTemplateImageFieldInput

| Field | Type | Default | Description |
|---|---|---|---|
| `label` | `String`! |  |  |
| `name` | `String`! |  |  |

### ContentGenerationBriefTemplateKeyValueFieldInput

| Field | Type | Default | Description |
|---|---|---|---|
| `label` | `String`! |  |  |
| `name` | `String`! |  |  |

### ContentGenerationBriefTemplateTextFieldInput

| Field | Type | Default | Description |
|---|---|---|---|
| `label` | `String`! |  |  |
| `name` | `String`! |  |  |
| `format` | [ContentGenerationBriefTemplateTextFieldFormat](https://amplience.com/developers/docs/apis/asset-management/reference/enums#contentgenerationbrieftemplatetextfieldformat)! |  |  |

### CreateContentGenerationToneInput

| Field | Type | Default | Description |
|---|---|---|---|
| `cmsHubId` | `String`! |  |  |
| `label` | `String`! |  |  |
| `description` | `String`! |  |  |

### UpdateContentGenerationToneInput

| Field | Type | Default | Description |
|---|---|---|---|
| `id` | `ID`! |  |  |
| `label` | `String`! |  |  |
| `description` | `String`! |  |  |

### DeleteContentGenerationToneInput

| Field | Type | Default | Description |
|---|---|---|---|
| `id` | `ID`! |  |  |

### CreateContentGenerationExampleInput

| Field | Type | Default | Description |
|---|---|---|---|
| `brandVoiceId` | `ID`! |  |  |
| `briefTemplateId` | `ID`! |  |  |
| `label` | `String`! |  |  |
| `briefInputs` | `String`! |  |  |
| `output` | `String`! |  |  |
| `folderId` | `ID` |  |  |

### UpdateContentGenerationExampleInput

| Field | Type | Default | Description |
|---|---|---|---|
| `id` | `ID`! |  |  |
| `label` | `String` |  |  |
| `briefInputs` | `String` |  |  |
| `output` | `String` |  |  |
| `folderId` | `ID` |  |  |

### DeleteContentGenerationExampleInput

| Field | Type | Default | Description |
|---|---|---|---|
| `id` | `ID`! |  |  |

### CreateContentGenerationExampleFolderInput

| Field | Type | Default | Description |
|---|---|---|---|
| `brandVoiceId` | `ID`! |  |  |
| `briefTemplateId` | `ID`! |  |  |
| `parentFolderId` | `ID` |  |  |
| `label` | `String`! |  |  |

### UpdateContentGenerationExampleFolderInput

| Field | Type | Default | Description |
|---|---|---|---|
| `id` | `ID`! |  |  |
| `parentFolderId` | `ID` |  |  |
| `label` | `String` |  |  |

### DeleteContentGenerationExampleFolderInput

| Field | Type | Default | Description |
|---|---|---|---|
| `id` | `ID`! |  |  |

### CreateContentGenerationSessionInput

| Field | Type | Default | Description |
|---|---|---|---|
| `label` | `String`! |  |  |
| `briefTemplateId` | `ID`! |  |  |
| `cmsHubId` | `ID`! |  |  |

### UpdateContentGenerationSessionInput

| Field | Type | Default | Description |
|---|---|---|---|
| `id` | `ID`! |  |  |
| `label` | `String`! |  |  |

### DeleteContentGenerationSessionInput

| Field | Type | Default | Description |
|---|---|---|---|
| `id` | `ID`! |  |  |

### SubmitContentGenerationSessionMessageInput

| Field | Type | Default | Description |
|---|---|---|---|
| `sessionId` | `ID`! |  |  |
| `parentId` | `ID` |  |  |
| `updateSessionLabel` | `Boolean` |  |  |
| `organizationId` | `ID`! |  |  |
| `content` | [ContentGenerationSessionMessageBriefContentInput](#contentgenerationsessionmessagebriefcontentinput)! |  |  |

### ContentGenerationSessionMessageBriefContentInput

| Field | Type | Default | Description |
|---|---|---|---|
| `briefInputs` | `String`! |  |  |
| `modelId` | `String`! |  |  |
| `exampleIds` | \[`String`\] |  |  |
| `images` | \[[ContentGenerationSessionMessageBriefContentImageInput](#contentgenerationsessionmessagebriefcontentimageinput)\] |  |  |

### ContentGenerationSessionMessageBriefContentImageInput

| Field | Type | Default | Description |
|---|---|---|---|
| `url` | `String`! |  |  |
| `id` | `String`! |  |  |

### ContentGenerationSessionMessageTextSelectionInput

| Field | Type | Default | Description |
|---|---|---|---|
| `text` | `String` |  |  |
| `start` | `Int` |  |  |
| `end` | `Int` |  |  |

### SaveContentGenerationSessionMessageTextPropertyInput

| Field | Type | Default | Description |
|---|---|---|---|
| `pointer` | `String`! |  |  |
| `value` | `String`! |  |  |
| `messageId` | `ID`! |  |  |

### ScoreContentGenerationSessionMessageInput

| Field | Type | Default | Description |
|---|---|---|---|
| `messageId` | `ID`! |  |  |
| `pointer` | `String`! |  |  |
| `score` | [ContentGenerationSessionMessageScore](https://amplience.com/developers/docs/apis/asset-management/reference/enums#contentgenerationsessionmessagescore)! |  |  |

### GenerateEditForContentGenerationSessionMessagePropertyInput

| Field | Type | Default | Description |
|---|---|---|---|
| `organizationId` | `ID`! |  |  |
| `messageId` | `ID`! |  |  |
| `pointer` | `String`! |  |  |
| `fullText` | `String`! |  |  |
| `prompt` | `String`! |  |  |
| `modelId` | `String`! |  |  |
| `textSelection` | [ContentGenerationSessionMessageTextSelectionInput](#contentgenerationsessionmessagetextselectioninput) |  |  |

### SubmitContentGenerationJobInput

| Field | Type | Default | Description |
|---|---|---|---|
| `organizationId` | `ID`! |  |  |
| `hubId` | `ID`! |  |  |
| `briefTemplateId` | `ID`! |  |  |
| `content` | [ContentGenerationJobBriefContentInput](#contentgenerationjobbriefcontentinput)! |  |  |

### ContentGenerationJobBriefContentInput

If 'modelId' is not provided it will fallback to the default model on the brief template if available.
Otherwise it will fallback to the Amplience default model.

| Field | Type | Default | Description |
|---|---|---|---|
| `briefInputs` | `String`! |  |  |
| `modelId` | `String` |  |  |
| `exampleIds` | \[`String`\] |  |  |
| `images` | \[[ContentGenerationJobBriefContentImageInput](#contentgenerationjobbriefcontentimageinput)\] |  |  |

### ContentGenerationJobBriefContentImageInput

| Field | Type | Default | Description |
|---|---|---|---|
| `url` | `String`! |  |  |
| `id` | `String`! |  |  |

### EnableContentGenerationModelInput

| Field | Type | Default | Description |
|---|---|---|---|
| `id` | `ID`! |  |  |
| `cmsHubId` | `ID`! |  |  |

### DisableContentGenerationModelInput

| Field | Type | Default | Description |
|---|---|---|---|
| `id` | `ID`! |  |  |
| `cmsHubId` | `ID`! |  |  |

### RichTextGenerationInput

| Field | Type | Default | Description |
|---|---|---|---|
| `organizationId` | `ID`! |  |  |
| `prompts` | \[[RichTextGenerationPrompt](#richtextgenerationprompt)!\]! |  |  |

### RichTextGenerationPrompt

| Field | Type | Default | Description |
|---|---|---|---|
| `role` | [RichTextGenerationRole](https://amplience.com/developers/docs/apis/asset-management/reference/enums#richtextgenerationrole)! |  |  |
| `content` | `String`! |  |  |

### SEOGenerationInput

| Field | Type | Default | Description |
|---|---|---|---|
| `organizationId` | `ID`! |  |  |
| `variants` | `Int`! |  |  |
| `prompts` | \[[SEOGenerationPrompt](#seogenerationprompt)!\]! |  |  |

### SEOGenerationPrompt

| Field | Type | Default | Description |
|---|---|---|---|
| `role` | [RichTextGenerationRole](https://amplience.com/developers/docs/apis/asset-management/reference/enums#richtextgenerationrole)! |  |  |
| `content` | `String`! |  |  |

## Content review

### SubmitContentReviewInput

| Field | Type | Default | Description |
|---|---|---|---|
| `reviewTaskId` | `ID`! |  |  |
| `type` | [ContentReviewType](https://amplience.com/developers/docs/apis/asset-management/reference/enums#contentreviewtype)! |  |  |
| `comment` | `String` |  |  |
| `suggestedBody` | `String` |  |  |

### ContentReviewTaskFilterInput

| Field | Type | Default | Description |
|---|---|---|---|
| `status` | \[[ContentReviewTaskStatus](https://amplience.com/developers/docs/apis/asset-management/reference/enums#contentreviewtaskstatus)!\] |  |  |
| `tags` | \[`String`!\] |  |  |
| `attributes` | \[[ContentReviewTaskAttributeFilter](#contentreviewtaskattributefilter)!\] |  |  |
| `reviewerIds` | \[`ID`!\] |  | Can be User or Team IDs |
| `reviewedByUserIds` | \[`ID`!\] |  |  |
| `createdDate` | [DateTimeRangeInput](#datetimerangeinput) |  |  |
| `expiryDate` | [DateTimeRangeInput](#datetimerangeinput) |  |  |
| `dueDate` | [DateTimeRangeInput](#datetimerangeinput) |  |  |

### ContentReviewTaskAttributeFilter

| Field | Type | Default | Description |
|---|---|---|---|
| `key` | `String`! |  |  |
| `value` | `String`! |  |  |

### ContentReviewTaskFacetFilterInput

| Field | Type | Default | Description |
|---|---|---|---|
| `status` | \[[ContentReviewTaskStatus](https://amplience.com/developers/docs/apis/asset-management/reference/enums#contentreviewtaskstatus)\] |  |  |
| `attributes` | \[[ContentReviewTaskAttributeFilter](#contentreviewtaskattributefilter)!\] |  |  |
| `reviewerIds` | \[`ID`!\] |  | Can be User or Team IDs |
| `createdDate` | [DateTimeRangeInput](#datetimerangeinput) |  |  |
| `expiryDate` | [DateTimeRangeInput](#datetimerangeinput) |  |  |
| `dueDate` | [DateTimeRangeInput](#datetimerangeinput) |  |  |

### ContentReviewTaskSearchFilterInput

| Field | Type | Default | Description |
|---|---|---|---|
| `status` | \[[ContentReviewTaskStatus](https://amplience.com/developers/docs/apis/asset-management/reference/enums#contentreviewtaskstatus)\] |  |  |
| `attributes` | \[[ContentReviewTaskAttributeFilter](#contentreviewtaskattributefilter)!\] |  |  |
| `reviewerIds` | \[`ID`!\] |  | Can be User or Team IDs |
| `createdDate` | [DateTimeRangeInput](#datetimerangeinput) |  |  |
| `expiryDate` | [DateTimeRangeInput](#datetimerangeinput) |  |  |
| `dueDate` | [DateTimeRangeInput](#datetimerangeinput) |  |  |

### ContentReviewTaskSortInput

| Field | Type | Default | Description |
|---|---|---|---|
| `key` | [ContentReviewTaskSortKey](https://amplience.com/developers/docs/apis/asset-management/reference/enums#contentreviewtasksortkey)! |  |  |
| `order` | [SortOrder](https://amplience.com/developers/docs/apis/asset-management/reference/enums#sortorder)! |  |  |

### DateTimeRangeInput

A range of date-time values used for filtering. Both bounds are optional and inclusive.

| Field | Type | Default | Description |
|---|---|---|---|
| `start` | `DateTime` |  | The start of the date range (inclusive). When provided without `end`, acts as an "on or after" filter. |
| `end` | `DateTime` |  | The end of the date range (inclusive). When provided without `start`, acts as an "on or before" filter. |

## Content flow

### CreateContentFlowInput

| Field | Type | Default | Description |
|---|---|---|---|
| `label` | `String`! |  |  |
| `description` | `String`! |  |  |
| `flow` | `String`! |  |  |
| `cmsHubId` | `ID`! |  |  |

### UpdateContentFlowInput

| Field | Type | Default | Description |
|---|---|---|---|
| `id` | `ID`! |  |  |
| `label` | `String` |  |  |
| `description` | `String` |  |  |
| `flow` | `String` |  |  |

### DeleteContentFlowInput

| Field | Type | Default | Description |
|---|---|---|---|
| `id` | `ID`! |  |  |

### RunContentFlowInput

| Field | Type | Default | Description |
|---|---|---|---|
| `flowId` | `ID`! |  |  |
| `label` | `String` |  |  |
| `flow` | `String` |  |  |
| `trigger` | [RunContentFlowTriggerInput](#runcontentflowtriggerinput)! |  |  |
| `attributes` | \[[RunContentFlowAttributeInput](#runcontentflowattributeinput)!\]! |  |  |
| `tags` | \[`String`!\]! |  |  |

### RunContentFlowAttributeInput

| Field | Type | Default | Description |
|---|---|---|---|
| `key` | `String`! |  |  |
| `value` | `String`! |  |  |

### RunContentFlowTriggerInput

| Field | Type | Default | Description |
|---|---|---|---|
| `actionId` | `String`! |  |  |
| `portName` | `String`! |  |  |
| `payload` | `String` |  |  |

### CancelContentFlowRunInput

| Field | Type | Default | Description |
|---|---|---|---|
| `id` | `ID`! |  |  |

### SetContentFlowStatusInput

| Field | Type | Default | Description |
|---|---|---|---|
| `id` | `ID`! |  |  |
| `status` | [ContentFlowStatus](https://amplience.com/developers/docs/apis/asset-management/reference/enums#contentflowstatus)! |  |  |