---
canonical_url: "https://docs.composio.dev/toolkits/contentdrips"
markdown_url: "https://docs.composio.dev/toolkits/contentdrips.md"
product: "platform"
version: null
last_updated: null
---

# Contentdrips

Contentdrips generates branded graphics and carousels from reusable templates through an asynchronous rendering API.

- **Category:** ai content generation
- **Auth:** API_KEY
- **Composio-managed OAuth available?** N/A
- **Tools:** 4
- **Triggers:** 0
- **Slug:** `CONTENTDRIPS`
- **Version:** 00000000_00

## Tools

### Get Render Job

**Slug:** `CONTENTDRIPS_GET_RENDER_JOB`

Get a Contentdrips render job's current state. Checks status once, fetches export URLs only after completion, and returns failed jobs as terminal data without polling automatically.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `job_id` | string | Yes | Render job UUID returned by one of the start-render tools. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Start AI Carousel Render

**Slug:** `CONTENTDRIPS_START_AI_CAROUSEL_RENDER`

Generate carousel copy from a topic or supported HTTPS source URL and queue its render. This consumes render quota and may also consume AI credits.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `output` | string ("png" | "pdf") | Yes | Required export format. PNG may produce one URL per slide; PDF produces one URL. |
| `ai_input` | string | Yes | Non-empty topic text for topic, or an absolute HTTPS URL for blog, youtube, or tiktok_reel. |
| `ai_method` | string ("topic" | "blog" | "youtube" | "tiktok_reel") | Yes | How Contentdrips should source the generated carousel copy. |
| `template_id` | string | Yes | Non-empty ID of a carousel template owned by the connected account; this API cannot discover template IDs. |
| `content_update` | array | No | Optional template element replacements to apply alongside generated carousel content. |
| `canvas_background` | object | No | Optional canvas fill configuration. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Start Carousel Render

**Slug:** `CONTENTDRIPS_START_CAROUSEL_RENDER`

Queue a manually authored multi-slide carousel as PNG files or a PDF from a known account-owned template. Queuing consumes render quota.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `output` | string ("png" | "pdf") | Yes | Export format. PNG may produce one URL per slide; PDF produces one URL. |
| `branding` | object | No | Optional branding values to apply to matching template fields. |
| `template_id` | string | Yes | Non-empty ID of a carousel template owned by the connected account; this API cannot discover template IDs. |
| `content_update` | array | No | Optional shared template replacements outside slide-specific content. |
| `carousel_content` | object | Yes | Authored carousel content using the current carousel_content contract. |
| `canvas_background` | object | No | Optional canvas fill configuration. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Start Graphic Render

**Slug:** `CONTENTDRIPS_START_GRAPHIC_RENDER`

Queue a PNG or PDF render from a known account-owned Contentdrips template and return the asynchronous job ID. Queuing consumes render quota.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `output` | string ("png" | "pdf") | Yes | Required export format. Use 'png' for an image or 'pdf' for a PDF. |
| `branding` | object | No | Optional branding values applied to matching template fields. |
| `template_id` | string | Yes | ID of a graphic template owned by the connected Contentdrips account. The Render API cannot discover template IDs. |
| `content_update` | array | No | Template element replacements whose labels match the template's meta-labels. |
| `canvas_background` | object | No | Optional canvas fill configuration. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |