# Taisly Docs

- [Taisly Docs](/en/docs): Publish short-form videos from AI agents, MCP connectors, the Taisly CLI, and direct API integrations.
- [Getting Started](/en/docs/getting-started): Connect social accounts, choose the right integration path, and publish your first video through Taisly.
- Agents
  - [Upload and publish videos with Taisly MCP](/en/docs/agents/upload-video-with-mcp): Use Taisly MCP with Claude, Claude Code, Codex, ChatGPT, and other AI agents.
  - [Agent Kit](/en/docs/agents/agent-kit): Install and use the official Taisly Agent Kit package, CLI, skill file, and local MCP server.
- API
  - [API Overview](/en/docs/api): Use the Taisly REST API to manage API keys, list platforms, create posts, inspect history, and configure repost rules.
  - [API Reference](/en/docs/api/reference): Endpoint reference generated from the Taisly OpenAPI document.
  - API Key Management: Generate, view, and revoke API keys for authentication. API keys are available on every plan. Usage limits depend on the plan.
    - [Get API Key Information](/en/docs/api/api-key-management/getApiKey): Retrieve information about your current API key.
    - [Generate API Key](/en/docs/api/api-key-management/generateApiKey): Generate a new API key or regenerate if one already exists.

**IMPORTANT**:
- The full API key is only shown once. Save it securely.
- If you regenerate, the old key will be invalidated immediately.
    - [Revoke API Key](/en/docs/api/api-key-management/revokeApiKey): Immediately revoke your current API key. All requests using this key will fail.
  - Platforms: View connected social media accounts.
    - [Get Connected Platforms](/en/docs/api/platforms/getPlatforms): Retrieve all social media accounts connected to your account.
  - Posts: Upload videos and post to multiple platforms simultaneously. Schedule posts for later or post immediately.
    - [Create a Post](/en/docs/api/posts/createPost): Upload a video to one or more connected platforms.

**Video Requirements:**
- Format: MP4, MOV, or other common video formats
- Size: Maximum 500MB
- Duration: 3-90 seconds
- Orientation: Vertical (9:16)

**Scheduling:**
- Pass `scheduled` as a Unix timestamp in milliseconds for scheduled posting (omit this parameter if you don't want to schedule)
    - [Get Post History](/en/docs/api/posts/getPostHistory): Retrieve your posting history with status information for each platform.

**Pagination**:
- Use `page` parameter for pagination (10 items per page)
- Or use `startTime` and `endTime` for date range filtering (returns all matching posts)

**Status Values**:
- PENDING: Post is queued
- SUCCESS: Posted successfully
- FAILED: Post failed (check message field for error code)
    - [Cancel Scheduled Post](/en/docs/api/posts/cancelScheduledPost): Cancel a post that was scheduled for later. The post will be permanently deleted.
  - Reposts: Configure automatic reposting rules to share content from one platform to others automatically.
    - [Get Repost Configurations](/en/docs/api/reposts/getReposts): Retrieve all configured automatic reposting rules. When you post to a 'from' platform, the content will be automatically reposted to all 'to' platforms.
    - [Add Repost Configuration](/en/docs/api/reposts/addRepost): Configure automatic reposting from one platform to others.

**How it works**:
- When you post content to the 'from' platform, it will automatically be reposted to all 'to' platforms

**Note**: Circular dependencies are prevented. You cannot create A→B if B→A already exists.
    - [Delete Repost Configuration](/en/docs/api/reposts/deleteRepost): Remove an automatic reposting rule. Future posts to the source platform will no longer be automatically reposted.
    - [Pause/Resume Repost Configuration](/en/docs/api/reposts/pauseRepost): Temporarily pause or resume automatic reposting. Useful when you want to stop reposting temporarily without deleting the configuration.
- Links
  - [App](https://app.taisly.com)
  - [Website](https://taisly.com)
  - [GitHub](https://github.com/taisly/agent)

# Taisly Docs

- [Taisly 文档](/zh-CN/docs): 使用 AI agent、MCP 连接器、Taisly CLI 和 API 发布短视频。
- [Getting Started](/zh-CN/docs/getting-started): Connect social accounts, choose the right integration path, and publish your first video through Taisly.
- Agents
  - [Upload and publish videos with Taisly MCP](/zh-CN/docs/agents/upload-video-with-mcp): Use Taisly MCP with Claude, Claude Code, Codex, ChatGPT, and other AI agents.
  - [Agent Kit](/zh-CN/docs/agents/agent-kit): Install and use the official Taisly Agent Kit package, CLI, skill file, and local MCP server.
- API
  - [API Overview](/zh-CN/docs/api): Use the Taisly REST API to manage API keys, list platforms, create posts, inspect history, and configure repost rules.
  - [API Reference](/zh-CN/docs/api/reference): Endpoint reference generated from the Taisly OpenAPI document.
  - API Key Management: Generate, view, and revoke API keys for authentication. API keys are available on every plan. Usage limits depend on the plan.
    - [Get API Key Information](/zh-CN/docs/api/api-key-management/getApiKey): Retrieve information about your current API key.
    - [Generate API Key](/zh-CN/docs/api/api-key-management/generateApiKey): Generate a new API key or regenerate if one already exists.

**IMPORTANT**:
- The full API key is only shown once. Save it securely.
- If you regenerate, the old key will be invalidated immediately.
    - [Revoke API Key](/zh-CN/docs/api/api-key-management/revokeApiKey): Immediately revoke your current API key. All requests using this key will fail.
  - Platforms: View connected social media accounts.
    - [Get Connected Platforms](/zh-CN/docs/api/platforms/getPlatforms): Retrieve all social media accounts connected to your account.
  - Posts: Upload videos and post to multiple platforms simultaneously. Schedule posts for later or post immediately.
    - [Create a Post](/zh-CN/docs/api/posts/createPost): Upload a video to one or more connected platforms.

**Video Requirements:**
- Format: MP4, MOV, or other common video formats
- Size: Maximum 500MB
- Duration: 3-90 seconds
- Orientation: Vertical (9:16)

**Scheduling:**
- Pass `scheduled` as a Unix timestamp in milliseconds for scheduled posting (omit this parameter if you don't want to schedule)
    - [Get Post History](/zh-CN/docs/api/posts/getPostHistory): Retrieve your posting history with status information for each platform.

**Pagination**:
- Use `page` parameter for pagination (10 items per page)
- Or use `startTime` and `endTime` for date range filtering (returns all matching posts)

**Status Values**:
- PENDING: Post is queued
- SUCCESS: Posted successfully
- FAILED: Post failed (check message field for error code)
    - [Cancel Scheduled Post](/zh-CN/docs/api/posts/cancelScheduledPost): Cancel a post that was scheduled for later. The post will be permanently deleted.
  - Reposts: Configure automatic reposting rules to share content from one platform to others automatically.
    - [Get Repost Configurations](/zh-CN/docs/api/reposts/getReposts): Retrieve all configured automatic reposting rules. When you post to a 'from' platform, the content will be automatically reposted to all 'to' platforms.
    - [Add Repost Configuration](/zh-CN/docs/api/reposts/addRepost): Configure automatic reposting from one platform to others.

**How it works**:
- When you post content to the 'from' platform, it will automatically be reposted to all 'to' platforms

**Note**: Circular dependencies are prevented. You cannot create A→B if B→A already exists.
    - [Delete Repost Configuration](/zh-CN/docs/api/reposts/deleteRepost): Remove an automatic reposting rule. Future posts to the source platform will no longer be automatically reposted.
    - [Pause/Resume Repost Configuration](/zh-CN/docs/api/reposts/pauseRepost): Temporarily pause or resume automatic reposting. Useful when you want to stop reposting temporarily without deleting the configuration.
- Links
  - [App](https://app.taisly.com)
  - [Website](https://taisly.com)
  - [GitHub](https://github.com/taisly/agent)