---
title: "POST /v2/content/generate-caption/start"
method: POST
path: "/v2/content/generate-caption/start"
tags: ["v2"]
---

# POST /v2/content/generate-caption/start

`POST /v2/content/generate-caption/start`

## Request

- Base URL: `https://api.inside.ad/api`
- URL: `https://api.inside.ad/api/v2/content/generate-caption/start`
- Auth: one of:
  - OAuth 2 (authorization code, authorization URL `https://api.inside.ad/api/oauth/authorize`, token URL `https://api.inside.ad/api/oauth/token`, scopes: `content:write`)
  - API key in header `authorization`

Starts asynchronous AI caption generation for a post. Returns a jobId immediately — poll "check_generate_caption" with it until status is "done" (result.post has the generated text), then pass that text as "caption" to create_content/update_post_caption.

## Query parameters

- `userId` number, required

## Request body

- object
  - `platform` 'instagram' | 'threads' | 'telegram'
  - `contentType` 'outgoing' | 'account', required
  - `contentId` number, nullable: Existing content id, if regenerating for an already-created post
  - `channelId` string, required
  - `textModel` string, nullable
  - `styleOverrides` object, nullable
    - `postTov` string, nullable
    - `postStyle` string, nullable
    - `teaserTov` string, nullable
    - `teaserStyle` string, nullable
    - `customPrompt` string, nullable
    - `useChannelInfo` number, nullable

## Response `200`

Default Response

- object
  - `jobId` string, required
  - `status` string, required

---

[API](https://skmtc.dev/inside/apis/inside-ad-api-documentation-v2-ai-optimized.md) · [All operations](https://skmtc.dev/inside/apis/inside-ad-api-documentation-v2-ai-optimized/llms.txt) · [OpenAPI document](https://skmtc.dev/inside/apis/inside-ad-api-documentation-v2-ai-optimized/revisions/79912b433f7f?raw)