> For the complete documentation index, see [llms.txt](https://developers.gamma.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.gamma.app/reference/warnings.md).

# 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.

{% hint style="info" %}
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.
{% endhint %}

### 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:**

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

**Response:**

```json
{
  "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:**

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

**Response:**

```json
{
  "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:**

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

**Response:**

```json
{
  "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}](https://developers.gamma.app/images/get-image-generation-status.md).

#### 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}](https://developers.gamma.app/agent-gamma-5/get-agent-generation-status.md). 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:**

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

**Response (workspace sharing restricted):**

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

**Response (access links disabled):**

```json
{
  "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](https://developers.gamma.app/reference/error-codes.md) for fatal API errors
* [Generate from text](https://developers.gamma.app/guides/generate-api-parameters-explained.md) for parameter interactions that commonly produce warnings
* [Generate from template](https://developers.gamma.app/guides/create-from-template-api-parameters-explained.md) for the template-specific workflow
* [POST /images](https://developers.gamma.app/images/create-image-generation.md) for standalone image generation warnings


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://developers.gamma.app/reference/warnings.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
