# Flint (/integrations/flint)



{/* MANUAL-CONTENT-START:intro */}

Use [Flint](https://www.flint.com/) in Sim to start site changes from a natural-language prompt, generate up to 10 pages from a template, and check task status. Create an API key in your Flint team settings. Leave publishing off when changes need review, then use **Get Task** to collect preview URLs and the list of created, modified, or deleted pages. Poll the task until it finishes and inspect its error if it fails.

{/* MANUAL-CONTENT-END */}

## Use the block [#usage-instructions]

Create background agent tasks that modify your Flint sites from natural-language prompts, generate batches of pages from a template, and check task status and results.

## Actions [#actions]

### Flint Create Task [#flint-create-task]

Start a background Flint agent task that modifies a site from a natural-language prompt.

#### Input [#input]

| Parameter | Type | Required | Description |
| - | - | - | - |
| `apiKey` | string | Yes | Flint API key (found in Flint team settings, starts with ak\_) |
| `siteId` | string | Yes | ID of the Flint site the agent should modify |
| `prompt` | string | Yes | Natural-language instructions for the agent (e.g., "Add a new About page with a team section") |
| `callbackUrl` | string | No | HTTPS webhook URL that Flint will POST to when the task completes or fails |
| `publish` | boolean | No | Whether to automatically publish the changes when the task completes |

#### Output [#output]

| Parameter | Type | Description |
| - | - | - |
| `taskId` | string | Identifier of the created background task |
| `status` | string | Initial task status (running) |
| `createdAt` | string | ISO 8601 timestamp when the task was created |

### Flint Generate Pages [#flint-generate-pages]

Start a background Flint agent task that generates up to 10 pages from a template page.

#### Input [#input-1]

| Parameter | Type | Required | Description |
| - | - | - | - |
| `apiKey` | string | Yes | Flint API key (found in Flint team settings, starts with ak\_) |
| `siteId` | string | Yes | ID of the Flint site the agent should modify |
| `templatePageSlug` | string | Yes | Slug of the existing template page to generate from (e.g., /case-studies/template) |
| `items` | array | Yes | JSON array of 1-10 pages to generate. Each item requires targetPageSlug (slug for the new page) and context (content details the agent should use). |
| `callbackUrl` | string | No | HTTPS webhook URL that Flint will POST to when the task completes or fails |
| `publish` | boolean | No | Whether to automatically publish the generated pages when the task completes |

#### Output [#output-1]

| Parameter | Type | Description |
| - | - | - |
| `taskId` | string | Identifier of the created background task |
| `status` | string | Initial task status (running) |
| `createdAt` | string | ISO 8601 timestamp when the task was created |

### Flint Get Task [#flint-get-task]

Get the status and results of a background Flint agent task.

#### Input [#input-2]

| Parameter | Type | Required | Description |
| - | - | - | - |
| `apiKey` | string | Yes | Flint API key (found in Flint team settings, starts with ak\_) |
| `taskId` | string | Yes | Identifier of the task returned when it was created (e.g., bg-...) |

#### Output [#output-2]

| Parameter | Type | Description |
| - | - | - |
| `taskId` | string | Identifier of the task |
| `status` | string | Task status: running, completed, or failed |
| `pagesCreated` | array | Pages created by the task (populated when completed) |
| `pagesModified` | array | Pages modified by the task (populated when completed) |
| `pagesDeleted` | array | Pages deleted by the task (populated when completed) |
| `errorMessage` | string | Error message when the task failed |