Skill: Late API

Owner: mikipalet

Summary: Official Late API reference for scheduling posts across 13 social media platforms. Covers authentication, endpoints, webhooks, and platform-specific features. Use when building with the Late Social Media Scheduling API.

Tags: latest:0.1.0

Version history:

v0.1.0 | 2026-01-26T07:42:09.192Z | auto

Initial release of late-api skill

• Publishes the official Late API reference for scheduling posts across 13 social media platforms.
• Includes quick start guide with API endpoints for profiles, accounts, and post creation.
• Documents authentication, endpoints, OAuth, webhooks, media uploads, analytics, errors, and platform specifics.
• Provides links to detailed rule files for each API area.
• Lists all supported social platforms.

Archive index:

Archive v0.1.0: 15 files, 15198 bytes

Files: README.md (1938b), rules/accounts.md (2279b), rules/analytics.md (1846b), rules/authentication.md (1077b), rules/connect.md (3660b), rules/errors.md (1673b), rules/media.md (1824b), rules/platforms.md (5707b), rules/posts.md (2986b), rules/queue.md (1718b), rules/sdks.md (834b), rules/tools.md (2033b), rules/webhooks.md (2729b), SKILL.md (2318b), _meta.json (127b)

File v0.1.0:SKILL.md

---

name: late-api description: Official Late API reference for scheduling posts across 13 social media platforms. Covers authentication, endpoints, webhooks, and platform-specific features. Use when building with the Late Social Media Scheduling API.

Late API Reference

Schedule posts across 13 social media platforms with a single API.

Base URL: https://getlate.dev/api/v1

Docs: getlate.dev/docs

Quick Start

# 1. Create profile
curl -X POST https://getlate.dev/api/v1/profiles \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"name": "My Brand"}'

# 2. Connect account (opens OAuth)
curl "https://getlate.dev/api/v1/connect/twitter?profileId=PROFILE_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"

# 3. Create post
curl -X POST https://getlate.dev/api/v1/posts \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"content": "Hello!", "platforms": [{"platform": "twitter", "accountId": "ACC_ID"}], "publishNow": true}'

Rule Files

Read individual rule files for detailed documentation:

• rules/authentication.md - API key format, usage examples, core concepts
• rules/posts.md - Create, schedule, retry posts, bulk upload
• rules/accounts.md - List accounts, health checks, follower stats
• rules/connect.md - OAuth flows, Bluesky app password, Telegram bot token
• rules/platforms.md - Platform-specific data for all 13 platforms
• rules/webhooks.md - Configure webhooks, verify signatures, events
• rules/media.md - Presigned uploads, supported formats, platform limits
• rules/queue.md - Queue management, slots configuration
• rules/analytics.md - YouTube daily views, LinkedIn analytics
• rules/tools.md - Media download, hashtag checker, transcripts
• rules/errors.md - Error codes, rate limits, publishing logs
• rules/sdks.md - Direct API usage examples

Supported Platforms

Twitter/X, Instagram, Facebook, LinkedIn, TikTok, YouTube, Pinterest, Reddit, Bluesky, Threads, Google Business, Telegram, Snapchat

---

Late - Social Media Scheduling API for Developers

File v0.1.0:README.md

Late API Skill

Official Claude Code skill for the Late Social Media Scheduling API.

Installation

npx skills add mikipalet/skills/late-api

What's Included

• Authentication - API key setup and usage
• Quick Start - Get posting in 4 steps
• All Endpoints - Posts, accounts, profiles, webhooks, media
• Platform-Specific - Features for all 13 platforms
• Webhooks - Setup and signature verification
• Error Handling - Common errors and solutions
• Code Examples - curl, TypeScript, Python

13 Platforms Supported

Twitter/X, Instagram, Facebook, LinkedIn, TikTok, YouTube, Pinterest, Reddit, Bluesky, Threads, Google Business, Telegram, Snapchat

Usage

Once installed, Claude Code will help you with Late API integration:

/late-api

Example Prompts

• "How do I create a post with the Late API?"
• "Show me how to set up webhooks"
• "What's the endpoint for connecting a Twitter account?"
• "How do I upload media to Late?"

Quick Example

const response = await fetch('https://getlate.dev/api/v1/posts', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${process.env.LATE_API_KEY}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    content: 'Hello from Late API!',
    platforms: [{ platform: 'twitter', accountId: 'acc_123' }],
    publishNow: true
  })
});

Resources

• Docs: getlate.dev/docs
• Dashboard: getlate.dev/dashboard
• API Keys: getlate.dev/dashboard/api-keys

License

MIT

---

Late - Social Media Scheduling API for Developers

File v0.1.0:_meta.json

{ "ownerId": "kn76zqp7wtxen0ast34y6jhmv97zz1b9", "slug": "late-api", "version": "0.1.0", "publishedAt": 1769413329192 }

File v0.1.0:rules/accounts.md

Accounts API

Endpoints

| Method | Endpoint | Description | |--------|----------|-------------| | GET | /v1/accounts | List accounts | | PUT | /v1/accounts/{accountId} | Update account | | DELETE | /v1/accounts/{accountId} | Disconnect account | | GET | /v1/accounts/health | Check all accounts health | | GET | /v1/accounts/{accountId}/health | Check specific account health | | GET | /v1/accounts/follower-stats | Get follower statistics |

Platform-Specific Account Endpoints

| Method | Endpoint | Description | |--------|----------|-------------| | PUT | /v1/accounts/{accountId}/facebook-page | Update selected Facebook page | | GET | /v1/accounts/{accountId}/gmb-reviews | Get Google Business reviews | | GET | /v1/accounts/{accountId}/linkedin-organizations | List LinkedIn organizations | | PUT | /v1/accounts/{accountId}/linkedin-organization | Switch personal/organization mode | | GET | /v1/accounts/{accountId}/linkedin-mentions | Get LinkedIn mentions | | GET | /v1/accounts/{accountId}/linkedin-aggregate-analytics | Get LinkedIn analytics | | GET | /v1/accounts/{accountId}/linkedin-post-analytics | Get LinkedIn post analytics | | GET | /v1/accounts/{accountId}/pinterest-boards | List Pinterest boards | | PUT | /v1/accounts/{accountId}/pinterest-boards | Set default Pinterest board | | GET | /v1/accounts/{accountId}/reddit-subreddits | List user's subreddits | | PUT | /v1/accounts/{accountId}/reddit-subreddits | Set default subreddit |

List Accounts

curl "https://getlate.dev/api/v1/accounts?profileId=PROFILE_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"

Account Health Check

curl "https://getlate.dev/api/v1/accounts/health" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response indicates if tokens are valid or need reconnection.

Account Groups

| Method | Endpoint | Description | |--------|----------|-------------| | GET | /v1/account-groups | List account groups | | POST | /v1/account-groups | Create account group | | PUT | /v1/account-groups/{groupId} | Update account group | | DELETE | /v1/account-groups/{groupId} | Delete account group |

Account groups let you organize accounts for bulk posting operations.

File v0.1.0:rules/analytics.md

Analytics API

Endpoints

| Method | Endpoint | Description | |--------|----------|-------------| | GET | /v1/analytics | Get general analytics | | GET | /v1/analytics/youtube/daily-views | Get YouTube video daily views | | GET | /v1/accounts/{accountId}/linkedin-aggregate-analytics | LinkedIn account analytics | | GET | /v1/accounts/{accountId}/linkedin-post-analytics | LinkedIn post analytics | | GET | /v1/accounts/follower-stats | Follower count history |

YouTube Daily Views

curl "https://getlate.dev/api/v1/analytics/youtube/daily-views?accountId=ACCOUNT_ID&videoId=VIDEO_ID&startDate=2024-01-01&endDate=2024-01-31" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response:

{
  "success": true,
  "videoId": "dQw4w9WgXcQ",
  "dateRange": {
    "startDate": "2024-01-01",
    "endDate": "2024-01-31"
  },
  "totalViews": 15420,
  "dailyViews": [
    {
      "date": "2024-01-01",
      "views": 523,
      "estimatedMinutesWatched": 1045,
      "averageViewDuration": 120,
      "subscribersGained": 12,
      "subscribersLost": 2,
      "likes": 45,
      "comments": 8,
      "shares": 15
    }
  ]
}

Note: Requires yt-analytics.readonly scope. If missing, response includes reauthorizeUrl.

LinkedIn Analytics

# Aggregate analytics for account
curl "https://getlate.dev/api/v1/accounts/ACCOUNT_ID/linkedin-aggregate-analytics" \
  -H "Authorization: Bearer YOUR_API_KEY"

# Analytics for specific post
curl "https://getlate.dev/api/v1/accounts/ACCOUNT_ID/linkedin-post-analytics?postUrn=URN" \
  -H "Authorization: Bearer YOUR_API_KEY"

Follower Stats

curl "https://getlate.dev/api/v1/accounts/follower-stats?profileId=PROFILE_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"

Returns historical follower counts across all connected accounts.

File v0.1.0:rules/authentication.md

Authentication

API Key Format

sk_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8s9t0u1v2w3x4y5z6

• Prefix: sk_
• Length: 67 characters
• Get yours at: getlate.dev/dashboard/api-keys

Usage Examples

curl

curl https://getlate.dev/api/v1/profiles \
  -H "Authorization: Bearer YOUR_API_KEY"

TypeScript

const response = await fetch('https://getlate.dev/api/v1/profiles', {
  headers: {
    'Authorization': `Bearer ${process.env.LATE_API_KEY}`
  }
});

Python

import requests

response = requests.get(
    'https://getlate.dev/api/v1/profiles',
    headers={'Authorization': f'Bearer {api_key}'}
)

Core Concepts

Profile (brand/project)
  └── Account (connected social account)
        └── Post (content to publish)

• Profile - Container that groups social accounts (think "brand" or "project")
• Account - Connected social media account (Twitter, Instagram, etc.)
• Post - Content to publish, can target multiple accounts at once

File v0.1.0:rules/connect.md

Connect (OAuth) API

Endpoints

| Method | Endpoint | Description | |--------|----------|-------------| | GET | /v1/connect/{platform} | Start OAuth flow | | POST | /v1/connect/bluesky/credentials | Connect Bluesky (app password) | | GET | /v1/connect/telegram | Generate Telegram access code | | POST | /v1/connect/telegram | Direct connect via chat ID | | PATCH | /v1/connect/telegram | Poll connection status |

Platform Selection Endpoints

Some platforms require selecting a page/location after OAuth:

| Method | Endpoint | Description | |--------|----------|-------------| | GET | /v1/connect/facebook/select-page | List Facebook pages | | POST | /v1/connect/facebook/select-page | Select Facebook page | | GET | /v1/connect/linkedin/organizations | List available LinkedIn orgs | | POST | /v1/connect/linkedin/select-organization | Select LinkedIn org | | GET | /v1/connect/googlebusiness/locations | List GMB locations | | POST | /v1/connect/googlebusiness/select-location | Select GMB location | | GET | /v1/connect/pinterest/select-board | List Pinterest boards | | POST | /v1/connect/pinterest/select-board | Select Pinterest board | | GET | /v1/connect/snapchat/select-profile | List Snapchat profiles | | POST | /v1/connect/snapchat/select-profile | Select Snapchat profile |

OAuth Flow

Standard OAuth (most platforms)

# Get OAuth URL
curl "https://getlate.dev/api/v1/connect/twitter?profileId=PROFILE_ID&callbackUrl=https://yourapp.com/callback" \
  -H "Authorization: Bearer YOUR_API_KEY"

Returns { "url": "https://twitter.com/oauth/..." } - redirect user there.

Bluesky (App Password)

curl -X POST https://getlate.dev/api/v1/connect/bluesky/credentials \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "profileId": "PROFILE_ID",
    "identifier": "user.bsky.social",
    "appPassword": "xxxx-xxxx-xxxx-xxxx"
  }'

Telegram

Option 1: Access Code Flow (recommended)

# 1. Generate access code
curl "https://getlate.dev/api/v1/connect/telegram?profileId=PROFILE_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"

# Returns: { "code": "LATE-ABC123", "botUsername": "LateScheduleBot", ... }

# 2. User adds bot to channel and sends code to bot
# 3. Poll for connection status
curl -X PATCH "https://getlate.dev/api/v1/connect/telegram?code=LATE-ABC123" \
  -H "Authorization: Bearer YOUR_API_KEY"

# Returns: { "status": "pending" } or { "status": "connected", "account": {...} }

Option 2: Direct Chat ID (power users)

curl -X POST https://getlate.dev/api/v1/connect/telegram \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "profileId": "PROFILE_ID",
    "chatId": "-1001234567890"
  }'

The Late bot must already be added as admin in your channel/group.

Supported Platforms

| Platform | Auth Method | Notes | |----------|-------------|-------| | Twitter/X | OAuth 2.0 PKCE | Requires code verifier | | Instagram | OAuth 2.0 | 2-step token exchange | | Facebook | OAuth 2.0 | Requires page selection | | LinkedIn | OAuth 2.0 | Optional org selection | | TikTok | OAuth 2.0 | UX compliance required | | YouTube | Google OAuth | access_type=offline | | Pinterest | OAuth 2.0 | Requires board selection | | Reddit | OAuth 2.0 | Strict user-agent | | Bluesky | App password | No OAuth, uses AT Protocol | | Threads | OAuth 2.0 | Similar to Instagram | | Google Business | Google OAuth | Requires location selection | | Telegram | Chat ID | Uses Late's bot | | Snapchat | OAuth 2.0 | Allowlist-only |

File v0.1.0:rules/errors.md

Error Handling

Error Response Format

{
  "error": "Invalid API key",
  "code": "UNAUTHORIZED",
  "details": {}
}

HTTP Status Codes

| Status | Code | Meaning | |--------|------|---------| | 400 | BAD_REQUEST | Invalid parameters | | 401 | UNAUTHORIZED | Invalid/missing API key | | 403 | FORBIDDEN | Insufficient permissions | | 404 | NOT_FOUND | Resource not found | | 422 | VALIDATION_ERROR | Validation failed | | 429 | RATE_LIMITED | Too many requests | | 500 | INTERNAL_ERROR | Server error |

Rate Limits

| Plan | Requests/Minute | |------|-----------------| | Free | 60 | | Build | 120 | | Accelerate | 600 | | Unlimited | 1,200 |

Rate Limit Headers

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 45
X-RateLimit-Reset: 1709294400

Handle Rate Limits

async function fetchWithRetry(url: string, options: RequestInit) {
  const response = await fetch(url, options);

  if (response.status === 429) {
    const resetTime = response.headers.get('X-RateLimit-Reset');
    const waitMs = (Number(resetTime) * 1000) - Date.now();
    await sleep(Math.max(waitMs, 1000));
    return fetchWithRetry(url, options);
  }

  return response;
}

Publishing Logs

Check post logs for platform-specific errors:

curl "https://getlate.dev/api/v1/posts/POST_ID/logs" \
  -H "Authorization: Bearer YOUR_API_KEY"

Logs API

| Method | Endpoint | Description | |--------|----------|-------------| | GET | /v1/logs | List all publishing logs | | GET | /v1/logs/{logId} | Get specific log entry | | GET | /v1/posts/{postId}/logs | Get logs for a post |

Logs are retained for 7 days.

File v0.1.0:rules/media.md

Media Upload

Endpoints

| Method | Endpoint | Description | |--------|----------|-------------| | POST | /v1/media/presign | Get presigned upload URL |

Get Presigned URL

curl -X POST https://getlate.dev/api/v1/media/presign \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"filename": "image.jpg", "contentType": "image/jpeg"}'

Upload Flow

// 1. Get presigned URL
const { uploadUrl, fileUrl } = await getPresignedUrl('image.jpg', 'image/jpeg');

// 2. Upload to presigned URL
await fetch(uploadUrl, {
  method: 'PUT',
  body: fileBuffer,
  headers: { 'Content-Type': 'image/jpeg' }
});

// 3. Use fileUrl in post
await createPost({
  content: 'Check this out!',
  mediaItems: [{ type: 'image', url: fileUrl }],
  platforms: [{ platform: 'twitter', accountId: 'acc_123' }]
});

Supported Formats

| Type | Formats | Max Size | |------|---------|----------| | Images | JPG, PNG, WebP, GIF | 5MB | | Videos | MP4, MOV, WebM | 5GB | | Documents | PDF (LinkedIn only) | 100MB |

Platform Media Limits

| Platform | Max Images | Max Video | Special | |----------|-----------|-----------|---------| | Instagram | 8MB | 100MB stories, 300MB reels | 4:5 to 1.91:1 aspect | | TikTok | 20MB | 4GB, 10min max | 9:16 strict | | Twitter | 5MB | 512MB, 2min 20s | 1-4 images | | LinkedIn | 8MB | 5GB | 20 image carousel | | YouTube | 2MB thumbnail | 256GB | Resumable upload | | Facebook | 10MB | 4GB | 10 multi-image | | Threads | 8MB | 1GB, 5min | 10 carousel | | Pinterest | 32MB | 2GB | Requires cover image | | Bluesky | 1MB | 50MB, 3min | 4 images max | | Snapchat | 20MB | 500MB | AES encryption required | | Google Business | 5MB | N/A | Images only | | Reddit | 20MB | N/A | Via URL | | Telegram | 10MB | 50MB | 4096 char limit |

File v0.1.0:rules/platforms.md

Platform-Specific Features

Supported Platforms

| Platform | OAuth | Features | |----------|-------|----------| | Twitter/X | Yes | Posts, threads, images, videos | | Instagram | Yes | Feed, Stories, Reels, Carousels | | Facebook | Yes | Pages, Reels, Stories | | LinkedIn | Yes | Posts, images, videos, documents | | TikTok | Yes | Videos with privacy controls | | YouTube | Yes | Videos, Shorts | | Pinterest | Yes | Pins with images/videos | | Reddit | Yes | Posts with subreddit targeting | | Bluesky | App password | Posts, images, videos | | Threads | Yes | Posts, images, videos | | Google Business | Yes | Updates, photos, offers | | Telegram | Bot token | Messages, images, videos | | Snapchat | Yes | Stories, Spotlight |

Platform-Specific Data

Platform-specific data goes inside each platform entry in the platforms array:

{
  "platforms": [
    {
      "platform": "instagram",
      "accountId": "acc_123",
      "platformSpecificData": { ... }
    }
  ]
}

Twitter/X

{
  "platformSpecificData": {
    "threadItems": [
      { "content": "Second tweet" },
      { "content": "Third tweet", "mediaItems": [{ "type": "image", "url": "..." }] }
    ]
  }
}

Instagram

{
  "platformSpecificData": {
    "contentType": "story",
    "firstComment": "First comment!",
    "collaborators": ["username"],
    "shareToFeed": true,
    "userTags": [{ "username": "user", "x": 0.5, "y": 0.5 }],
    "trialParams": { "graduationStrategy": "SS_PERFORMANCE" },
    "audioName": "My Custom Audio",
    "thumbOffset": 5000
  }
}

• contentType: "story" publishes as a Story. Default posts become Reels or feed based on media.
• trialParams for Trial Reels (non-followers first): MANUAL or SS_PERFORMANCE (auto-graduate)
• audioName sets custom label for original audio in Reels
• thumbOffset selects thumbnail frame (milliseconds from start)

TikTok

{
  "platformSpecificData": {
    "privacyLevel": "PUBLIC_TO_EVERYONE",
    "allowComment": true,
    "allowDuet": true,
    "allowStitch": true,
    "contentPreviewConfirmed": true,
    "expressConsentGiven": true,
    "draft": false,
    "commercialContentType": "none",
    "videoMadeWithAi": false,
    "videoCoverTimestampMs": 1000,
    "photoCoverIndex": 0,
    "autoAddMusic": false,
    "description": "Extended description for photo posts (max 4000 chars)"
  }
}

Required fields:

• contentPreviewConfirmed and expressConsentGiven must be true
• allowDuet, allowStitch required for videos; allowComment for all

Optional fields:

• draft: true sends to Creator Inbox instead of publishing
• commercialContentType: none, brand_organic, brand_content
• brandPartnerPromote: Whether the post promotes a brand partner
• isBrandOrganicPost: Whether the post is a brand organic post
• mediaType: video or photo (auto-detected from media)
• description for photo posts when content exceeds 90 chars

YouTube

{
  "platformSpecificData": {
    "title": "Video Title",
    "visibility": "public",
    "firstComment": "Check out my other videos!",
    "containsSyntheticMedia": false
  }
}

• visibility: public, private, unlisted
• firstComment: Optional comment posted after upload (max 10,000 chars)
• containsSyntheticMedia: Set true for AI-generated content disclosure
• Videos ≤3 min auto-detected as Shorts; >3 min as regular videos
• Use top-level tags array for video tags (≤500 chars total)

Pinterest

{
  "platformSpecificData": {
    "title": "Pin Title",
    "boardId": "board_123",
    "link": "https://example.com",
    "coverImageUrl": "https://example.com/cover.jpg",
    "coverImageKeyFrameTime": 5
  }
}

• title: Pin title (max 100 chars, defaults to first line of content)
• boardId: Target board (uses first available if omitted)
• coverImageUrl: Optional cover image for video pins
• coverImageKeyFrameTime: Key frame time in seconds for video cover

Google Business

{
  "platformSpecificData": {
    "callToAction": {
      "type": "LEARN_MORE",
      "url": "https://example.com"
    }
  }
}

Action types: BOOK, ORDER, SHOP, LEARN_MORE, SIGN_UP, CALL

LinkedIn

{
  "platformSpecificData": {
    "firstComment": "First comment on the post",
    "disableLinkPreview": false
  }
}

Supports up to 20 images, single PDF documents (max 100MB), and link previews for URLs.

Facebook

{
  "platformSpecificData": {
    "contentType": "story",
    "firstComment": "First comment!",
    "pageId": "123456789"
  }
}

Set contentType: "story" to publish as a Facebook Page Story (24-hour ephemeral). Supports up to 10 images for feed posts.

Threads

{
  "platformSpecificData": {
    "threadItems": [
      { "content": "Second post in thread" },
      { "content": "Third post", "mediaItems": [{ "type": "image", "url": "..." }] }
    ]
  }
}

Creates reply chains (Threads equivalent of Twitter threads). Supports up to 10 images per carousel.

Telegram

{
  "platformSpecificData": {
    "parseMode": "HTML",
    "disableWebPagePreview": false,
    "disableNotification": false,
    "protectContent": false
  }
}

Parse modes: HTML, Markdown, MarkdownV2. Supports up to 10 images or videos in albums. Max 4096 chars for text-only, 1024 for media captions.

Snapchat

{
  "platformSpecificData": {
    "contentType": "story"
  }
}

Content types:

• story - Ephemeral (24 hours), no text caption
• saved_story - Permanent on Public Profile, title max 45 chars
• spotlight - Video for entertainment feed, description max 160 chars

File v0.1.0:rules/posts.md

Posts API

Endpoints

| Method | Endpoint | Description | |--------|----------|-------------| | POST | /v1/posts | Create post | | GET | /v1/posts | List posts | | GET | /v1/posts/{postId} | Get post | | PUT | /v1/posts/{postId} | Update post | | DELETE | /v1/posts/{postId} | Delete post | | POST | /v1/posts/{postId}/retry | Retry failed post | | GET | /v1/posts/{postId}/logs | Get publishing logs | | POST | /v1/posts/bulk-upload | Bulk create posts |

Create Post

const post = await fetch('https://getlate.dev/api/v1/posts', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${apiKey}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    // Required
    content: 'Your post content here',
    platforms: [
      {
        platform: 'twitter',
        accountId: 'acc_123',
        // Platform-specific data goes inside each platform entry
        platformSpecificData: {
          threadItems: [
            { content: 'Tweet 2' },
            { content: 'Tweet 3', mediaItems: [{ type: 'image', url: 'https://...' }] }
          ]
        }
      },
      {
        platform: 'instagram',
        accountId: 'acc_456',
        platformSpecificData: {
          contentType: 'story',  // only 'story' is explicit; feed/reel auto-determined by media
          firstComment: 'First comment text'
        }
      }
    ],

    // Scheduling (pick one)
    publishNow: true,                        // Publish immediately
    // OR
    scheduledFor: '2024-03-01T10:00:00Z',    // Schedule for later
    // OR
    queuedFromProfile: 'prof_123',           // Add to queue

    // Optional media (array of objects)
    mediaItems: [
      { type: 'image', url: 'https://...' },
      { type: 'video', url: 'https://...' }
    ]
  })
});

Post to Multiple Platforms

await fetch('https://getlate.dev/api/v1/posts', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${apiKey}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    content: 'Announcing our new feature!',
    platforms: [
      { platform: 'twitter', accountId: 'tw_123' },
      { platform: 'linkedin', accountId: 'li_456' },
      { platform: 'facebook', accountId: 'fb_789' }
    ],
    publishNow: true
  })
});

Schedule for Later

await fetch('https://getlate.dev/api/v1/posts', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${apiKey}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    content: 'Scheduled post',
    platforms: [{ platform: 'twitter', accountId: 'acc_123' }],
    scheduledFor: '2024-03-15T09:00:00Z'
  })
});

Retry Failed Posts

# List failed posts
curl "https://getlate.dev/api/v1/posts?status=failed" \
  -H "Authorization: Bearer YOUR_API_KEY"

# Retry a specific post
curl -X POST "https://getlate.dev/api/v1/posts/POST_ID/retry" \
  -H "Authorization: Bearer YOUR_API_KEY"

File v0.1.0:rules/queue.md

Queue API

Endpoints

| Method | Endpoint | Description | |--------|----------|-------------| | GET | /v1/queue/preview | Preview queue for profile | | GET | /v1/queue/next-slot | Get next available slot | | GET | /v1/queue/slots | Get queue slot configuration | | POST | /v1/queue/slots | Create a new queue | | PUT | /v1/queue/slots | Update queue slots | | DELETE | /v1/queue/slots | Delete a queue schedule |

Add Post to Queue

curl -X POST https://getlate.dev/api/v1/posts \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Queued post",
    "platforms": [{ "platform": "twitter", "accountId": "acc_123" }],
    "queuedFromProfile": "PROFILE_ID"
  }'

Preview Queue

curl "https://getlate.dev/api/v1/queue/preview?profileId=PROFILE_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"

Returns upcoming scheduled posts in queue order.

Get Next Slot

curl "https://getlate.dev/api/v1/queue/next-slot?profileId=PROFILE_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"

Returns the next available time slot for posting.

Configure Queue Slots

curl -X PUT https://getlate.dev/api/v1/queue/slots \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "profileId": "PROFILE_ID",
    "queueId": "QUEUE_ID",
    "slots": [
      { "dayOfWeek": 1, "time": "09:00" },
      { "dayOfWeek": 1, "time": "12:00" },
      { "dayOfWeek": 1, "time": "18:00" }
    ],
    "timezone": "America/New_York"
  }'

Queue slots define when posts are automatically published.

• dayOfWeek: 0-6 (0=Sunday, 6=Saturday)
• time: 24-hour format "HH:mm"