Warnings

Understanding warning messages in API responses.

In some cases, you may receive file-level warnings in response to a generation request. These flag ignored or adjusted options that apply to the whole gamma — for example, sharing settings, folder assignment, or card dimensions.

For example, if you specify 1x1 dimensions for a presentation, Gamma uses a valid default instead and returns a warning explaining the change.

Warnings are informational and do not prevent the generation from completing. Your Gamma will still be created, but some parameters may have been ignored or adjusted.

Quick reference

• Warnings do not stop generation.
• A warning usually means Gamma ignored a conflicting or incompatible parameter for the whole gamma.
• Common file-level cases include ignored sharing options, folder restrictions, and invalid dimension/format combinations.
• The warning string is returned alongside generationId in the creation response.

Common warning scenarios

Conflicting format and dimensions

If you specify card dimensions that don't match your chosen format, Gamma will use a valid default.

Request:

{
  "format": "presentation",
  "inputText": "Best hikes in the United States",
  "cardOptions": {
    "dimensions": "1x1"
  }
}

Response:

{
  "generationId": "xxxxxxxxxx",
  "warnings": "cardOptions.dimensions 1x1 is not valid for format presentation. Valid dimensions are: [ 16x9, 4x3, fluid ]. Using default: fluid."
}

Valid Dimensions by Format

Format	Valid Dimensions
presentation	16x9, 4x3, fluid
document	pageless, letter, a4, fluid
social	1x1, 4x5, 9x16
webpage	fluid

Conflicting image source and model

If you specify an image model but the source is not aiGenerated, the model will be ignored.

Request:

{
  "format": "presentation",
  "inputText": "Best hikes in the United States",
  "imageOptions": {
    "source": "pictographic",
    "model": "flux-1-pro"
  }
}

Response:

{
  "generationId": "xxxxxxxxxx",
  "warnings": "imageOptions.model and imageOptions.style are ignored when imageOptions.source is not aiGenerated."
}

textMode preserve with textOptions

When using textMode: "preserve", text generation options like amount, tone, and audience are ignored since your original text is being preserved.

Request:

{
  "inputText": "Your detailed content here...",
  "textMode": "preserve",
  "textOptions": {
    "amount": "brief",
    "tone": "casual"
  }
}

Response:

{
  "generationId": "xxxxxxxxxx",
  "warnings": "textOptions.amount and textOptions.tone are ignored when textMode is preserve."
}

Image generation warnings

Standalone image requests (POST /v1.0/images) return structured warnings in the warnings array. Each entry has a code and message. Warnings are informational — the generation still proceeds.

Code	Meaning
no_brand_theme_applied	No brand theme was found; a standard theme was used
theme_ignored_for_type	themeId was ignored because type is scene
theme_skipped_for_references	themeId was ignored because referenceImages were provided
curated_style_skipped_for_references	type was ignored because referenceImages were provided

Warnings can appear on the create response and again on the completed status response from GET /images/{id}.

Agent generation warnings

Agent generation requests (POST /v1.0/agent/generations) return structured warnings in the warnings array. Each entry has a code and message. Warnings are informational — the generation still proceeds unless the request fails with a fatal error.

Common cases include ignored or admin-restricted sharingOptions, a folderId that could not be applied, export failures when exportAs is set, and email invite issues. Warnings can appear on the create response and again on the completed or failed status response from GET /agent/generations/{generationId}. See the OpenAPI block on that page for the full warning code enum.

Workspace-restricted sharing fields

If a workspace admin has restricted workspace sharing or disabled access links, Gamma strips the corresponding sharingOptions field from your request and returns a warning. The generation still completes using the admin-enforced default.

Request:

{
  "inputText": "Q3 product strategy",
  "textMode": "generate",
  "sharingOptions": {
    "workspaceAccess": "comment",
    "externalAccess": "view"
  }
}

Response (workspace sharing restricted):

{
  "generationId": "xxxxxxxxxx",
  "warnings": "sharingOptions.workspaceAccess was ignored because workspace sharing is restricted by a workspace admin."
}

Response (access links disabled):

{
  "generationId": "xxxxxxxxxx",
  "warnings": "sharingOptions.externalAccess was ignored because access links are disabled by a workspace admin."
}

Best practices

• Log and review warnings during development so ignored parameters are easy to spot.
• Match format and cardOptions.dimensions to avoid unexpected defaults.
• Only specify imageOptions.model when imageOptions.source is aiGenerated.
• Treat textMode: "preserve" as higher priority than text-generation settings like amount, tone, or audience.

Related

• Error codes for fatal API errors
• Generate from text for parameter interactions that commonly produce warnings
• Generate from template for the template-specific workflow
• POST /images for standalone image generation warnings