> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pinkfish.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# gamma
> AI-powered presentation generation
**Server path:** `/gamma` | **Type:** Application | **PCID required:** Yes
## Tools
| Tool | Description |
| ------------------------------------------------------------- | ------------------------------------------------------------------------------------------ |
| [`gamma_generate_presentation`](#gamma_generate_presentation) | Generate an AI-powered presentation using Gamma |
| [`gamma_get_generation_status`](#gamma_get_generation_status) | Get the status of a specific Gamma generation to check if it is complete. |
| [`gamma_list_folders`](#gamma_list_folders) | List folders in Gamma workspace. Use this to find folder IDs for storing generated gammas. |
***
## gamma\_generate\_presentation
Generate an AI-powered presentation using Gamma
**Parameters:**
| Parameter | Type | Required | Default | Description |
| ------------------------ | --------- | -------- | ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `inputPrompt` | string | Yes | — | Text and image URLs used to generate your presentation. Can be as little as a few words or pages of text. Character limits: 1-100,000 tokens. Example: Pitch deck on deep sea exploration. |
| `textMode` | string | No | `"generate"` | How you want your inputPrompt to be modified by Gamma, if at all |
| `format` | string | No | `"presentation"` | The type of artifact you want to create |
| `themeId` | string | No | — | The theme from Gamma that will be used for your creation. You can create custom themes in Gamma. If nothing is specified, the default theme for your workspace is chosen. |
| `numCards` | number | No | `10` | How many cards you want to create when cardSplit is set to auto. Options: Pro users choose any integer between 1 and 60; Ultra users choose any integer between 1 and 75. |
| `cardSplit` | string | No | `"auto"` | How you want your content to be divided up |
| `additionalInstructions` | string | No | — | Extra specifications about the desired content and layouts. Character limits: 1-2000. Example: Make the titles catchy. |
| `folderIds` | string\[] | No | — | The folder(s) where you want to store your gamma |
| `exportAs` | string | No | — | Additional file types for saving your gamma |
| `textOptions` | object | No | — | Attributes of the text you want to generate |
| `imageOptions` | object | No | — | Attributes of the images you want to generate, if any |
| `cardOptions` | object | No | — | Attributes of the cards you want to generate. Related to the format parameter. |
| `sharingOptions` | object | No | — | Determines how your gamma is shared with others |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID"
},
"inputPrompt": {
"type": "string",
"description": "Text and image URLs used to generate your presentation. Can be as little as a few words or pages of text. Character limits: 1-100,000 tokens. Example: Pitch deck on deep sea exploration."
},
"textMode": {
"type": "string",
"enum": [
"generate",
"condense",
"preserve"
],
"default": "generate",
"description": "How you want your inputPrompt to be modified by Gamma, if at all"
},
"format": {
"type": "string",
"enum": [
"presentation",
"document",
"webpage",
"social"
],
"default": "presentation",
"description": "The type of artifact you want to create"
},
"themeId": {
"type": "string",
"description": "The theme from Gamma that will be used for your creation. You can create custom themes in Gamma. If nothing is specified, the default theme for your workspace is chosen."
},
"numCards": {
"type": "number",
"default": 10,
"description": "How many cards you want to create when cardSplit is set to auto. Options: Pro users choose any integer between 1 and 60; Ultra users choose any integer between 1 and 75."
},
"cardSplit": {
"type": "string",
"enum": [
"auto",
"inputTextBreaks"
],
"default": "auto",
"description": "How you want your content to be divided up"
},
"additionalInstructions": {
"type": "string",
"description": "Extra specifications about the desired content and layouts. Character limits: 1-2000. Example: Make the titles catchy."
},
"folderIds": {
"type": "array",
"items": {
"type": "string"
},
"description": "The folder(s) where you want to store your gamma"
},
"exportAs": {
"type": "string",
"enum": [
"pdf",
"pptx"
],
"description": "Additional file types for saving your gamma"
},
"textOptions": {
"type": "object",
"properties": {
"amount": {
"type": "string",
"enum": [
"less",
"medium",
"more"
],
"description": "Amount of text to generate"
},
"tone": {
"type": "string",
"description": "Tone of the text"
},
"audience": {
"type": "string",
"description": "Target audience"
},
"language": {
"type": "string",
"description": "Language code (e.g., \"en\", \"es\", \"fr\")"
}
},
"description": "Attributes of the text you want to generate"
},
"imageOptions": {
"type": "object",
"properties": {
"source": {
"type": "string",
"enum": [
"aiGenerated",
"web",
"none"
],
"description": "Source for images"
},
"model": {
"type": "string",
"description": "AI model for image generation"
},
"style": {
"type": "string",
"description": "Style for generated images"
}
},
"description": "Attributes of the images you want to generate, if any"
},
"cardOptions": {
"type": "object",
"properties": {
"dimensions": {
"type": "string",
"description": "Dimensions for the cards"
},
"headerFooter": {
"type": "object",
"properties": {
"topLeft": {
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"cardNumber",
"string"
],
"description": "Type of content for the position"
},
"value": {
"type": "string",
"description": "Value to display"
},
"source": {
"type": "string",
"enum": [
"themeLogo"
],
"description": "Source for logo if applicable"
},
"src": {
"type": "string",
"description": "Image source URL"
},
"size": {
"type": "string",
"enum": [
"sm",
"md",
"lg"
],
"description": "Size of the element"
}
}
},
"topCenter": {
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"cardNumber",
"string"
],
"description": "Type of content for the position"
},
"value": {
"type": "string",
"description": "Value to display"
},
"source": {
"type": "string",
"enum": [
"themeLogo"
],
"description": "Source for logo if applicable"
},
"src": {
"type": "string",
"description": "Image source URL"
},
"size": {
"type": "string",
"enum": [
"sm",
"md",
"lg"
],
"description": "Size of the element"
}
}
},
"topRight": {
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"cardNumber",
"string"
],
"description": "Type of content for the position"
},
"value": {
"type": "string",
"description": "Value to display"
},
"source": {
"type": "string",
"enum": [
"themeLogo"
],
"description": "Source for logo if applicable"
},
"src": {
"type": "string",
"description": "Image source URL"
},
"size": {
"type": "string",
"enum": [
"sm",
"md",
"lg"
],
"description": "Size of the element"
}
}
},
"bottomLeft": {
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"cardNumber",
"string"
],
"description": "Type of content for the position"
},
"value": {
"type": "string",
"description": "Value to display"
},
"source": {
"type": "string",
"enum": [
"themeLogo"
],
"description": "Source for logo if applicable"
},
"src": {
"type": "string",
"description": "Image source URL"
},
"size": {
"type": "string",
"enum": [
"sm",
"md",
"lg"
],
"description": "Size of the element"
}
}
},
"bottomCenter": {
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"cardNumber",
"string"
],
"description": "Type of content for the position"
},
"value": {
"type": "string",
"description": "Value to display"
},
"source": {
"type": "string",
"enum": [
"themeLogo"
],
"description": "Source for logo if applicable"
},
"src": {
"type": "string",
"description": "Image source URL"
},
"size": {
"type": "string",
"enum": [
"sm",
"md",
"lg"
],
"description": "Size of the element"
}
}
},
"bottomRight": {
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"cardNumber",
"string"
],
"description": "Type of content for the position"
},
"value": {
"type": "string",
"description": "Value to display"
},
"source": {
"type": "string",
"enum": [
"themeLogo"
],
"description": "Source for logo if applicable"
},
"src": {
"type": "string",
"description": "Image source URL"
},
"size": {
"type": "string",
"enum": [
"sm",
"md",
"lg"
],
"description": "Size of the element"
}
}
},
"hideFromFirstCard": {
"type": "boolean",
"description": "Hide header/footer from the first card"
},
"hideFromLastCard": {
"type": "boolean",
"description": "Hide header/footer from the last card"
}
},
"description": "Header and footer configuration"
}
},
"description": "Attributes of the cards you want to generate. Related to the format parameter."
},
"sharingOptions": {
"type": "object",
"properties": {
"workspaceAccess": {
"type": "string",
"enum": [
"noAccess",
"view",
"comment",
"edit"
],
"description": "Access level for workspace members"
},
"externalAccess": {
"type": "string",
"enum": [
"noAccess",
"view",
"comment",
"edit"
],
"description": "Access level for external users"
},
"emailOptions": {
"type": "object",
"properties": {
"recipients": {
"type": "array",
"items": {
"type": "string"
},
"description": "Email addresses to share with"
},
"access": {
"type": "string",
"enum": [
"view",
"comment",
"edit"
],
"description": "Access level for email recipients"
}
},
"description": "Email sharing options"
}
},
"description": "Determines how your gamma is shared with others"
}
},
"required": [
"PCID",
"inputPrompt"
]
}
```
***
## gamma\_get\_generation\_status
Get the status of a specific Gamma generation to check if it is complete.
**Parameters:**
| Parameter | Type | Required | Default | Description |
| -------------- | ------ | -------- | ------- | -------------------------------------------------------------------- |
| `generationId` | string | Yes | — | The generation ID from the response of gamma\_generate\_presentation |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID"
},
"generationId": {
"type": "string",
"description": "The generation ID from the response of gamma_generate_presentation"
}
},
"required": [
"PCID",
"generationId"
]
}
```
***
## gamma\_list\_folders
List folders in Gamma workspace. Use this to find folder IDs for storing generated gammas.
**Parameters:**
| Parameter | Type | Required | Default | Description |
| --------- | ------ | -------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| `query` | string | No | — | Search by folder name (case-sensitive). Filters results to folders matching the search term. |
| `limit` | number | No | — | Number of folders to return per page. Maximum: 50. |
| `after` | string | No | — | Cursor token for fetching the next page. Use the nextCursor value from the previous response to retrieve the next page of results. |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID"
},
"query": {
"type": "string",
"description": "Search by folder name (case-sensitive). Filters results to folders matching the search term."
},
"limit": {
"type": "number",
"description": "Number of folders to return per page. Maximum: 50."
},
"after": {
"type": "string",
"description": "Cursor token for fetching the next page. Use the nextCursor value from the previous response to retrieve the next page of results."
}
},
"required": [
"PCID"
]
}
```