> ## Documentation Index
> Fetch the complete documentation index at: https://developers.stover.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Posts Overview

> Create and schedule social media posts across multiple platforms

## Overview

The Posts API allows you to create and schedule content across multiple social media platforms from a single endpoint.

## Supported Platforms

| Platform    | Endpoint              | Content Limit    |
| ----------- | --------------------- | ---------------- |
| Instagram   | `/v1/posts/instagram` | 2,200 characters |
| LinkedIn    | `/v1/posts/linkedin`  | 3,000 characters |
| X (Twitter) | `/v1/posts/x`         | 280 characters   |
| Threads     | `/v1/posts/threads`   | 500 characters   |

## Authentication

All Posts API endpoints require authentication via API key:

```bash theme={null}
Authorization: Bearer stover_pk_your_api_key
```

## Common Fields

All platforms share these fields:

| Field            | Type      | Description                                     |
| ---------------- | --------- | ----------------------------------------------- |
| `user_id`        | UUID      | Your user ID (must match API key owner)         |
| `title`          | string    | Internal title for organization (max 200 chars) |
| `status`         | enum      | `draft`, `scheduled`, `published`, `failed`     |
| `scheduled_date` | ISO 8601  | When to publish (for scheduled posts)           |
| `hashtags`       | string\[] | Hashtags without # prefix                       |
| `media_urls`     | string\[] | URLs of media to attach                         |

## Post Status Workflow

```mermaid theme={null}
graph LR
    A[draft] --> B[scheduled]
    B --> C[published]
    B --> D[failed]
    A --> C
    A --> D
```

| Status      | Description                           |
| ----------- | ------------------------------------- |
| `draft`     | Saved but not scheduled               |
| `scheduled` | Will be published at `scheduled_date` |
| `published` | Successfully posted to platform       |
| `failed`    | Publishing failed (check error logs)  |

## Rate Limiting

| Limit               | Value |
| ------------------- | ----- |
| Requests per minute | 30    |
| Max payload size    | 50KB  |

## Platform-Specific Documentation

<CardGroup cols={2}>
  <Card title="Instagram" icon="instagram" href="/api-reference/posts/instagram">
    Feed posts, Reels, and Carousels
  </Card>

  <Card title="LinkedIn" icon="linkedin" href="/api-reference/posts/linkedin">
    Professional content sharing
  </Card>

  <Card title="X (Twitter)" icon="x-twitter" href="/api-reference/posts/x">
    Tweets with media and mentions
  </Card>

  <Card title="Threads" icon="threads" href="/api-reference/posts/threads">
    Text, images, videos, and carousels
  </Card>
</CardGroup>