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."
}

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