---
title: "Create Content"
method: POST
path: "/v1/content"
tags: ["content"]
---

# Create Content

`POST /v1/content`

## Request

- Base URL: `https://api.theagentc.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.theagentc.io/v1/content`
- Auth: HTTP bearer

Create a new content item in draft status.

The brand_id must belong to the current workspace.
Content is initially created as a draft and can be published later.

## Request body

- ContentCreate: Request model for creating content (draft).
  - `brand_id` string, uuid, required
  - `content_type` string, required: Type of content: text, image, video, thread, carousel, pin
  - `platform` string, required: Target platform: x, youtube, pinterest, instagram, instagram_reels
  - `body` object, required: Platform-specific content body with text, media_urls, hashtags, etc.
  - `scheduled_at` string, date-time, nullable: When to publish (optional)

## Response `201`

Successful Response

- ContentRead: Full content item response model.
  - `id` string, uuid, required
  - `run_id` string, uuid, nullable, required
  - `brand_id` string, uuid, required
  - `content_type` string, required
  - `platform` string, required
  - `body` object, required
  - `status` string, required
  - `platform_post_id` string, nullable, required
  - `rejection_feedback` string, nullable, required
  - `scheduled_at` string, date-time, nullable, required
  - `posted_at` string, date-time, nullable, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/theagentc/apis/the-agent-c-api.md) · [All operations](https://skmtc.dev/theagentc/apis/the-agent-c-api/llms.txt) · [OpenAPI document](https://skmtc.dev/theagentc/apis/the-agent-c-api/revisions/1c9868b44584?raw)