Shorts V2 Skill

Use this skill when the job is operational publishing through Shorts V2: connect channels, create schedules, upload slideshow assets, publish to TikTok or YouTube, and poll TikTok inbox processing until it reaches a terminal state.

What This Skill Covers

• channel lookup with GET /api/v2/channels
• schedule creation with JSON or multipart/form-data
• immediate publish with POST /api/v2/schedules/{schedule_id}/publish
• TikTok inbox refresh with GET /api/v2/schedules/{schedule_id}/status
• credit handling and retry flow through /plans

This skill is intentionally narrow. It is the publishing layer, not the research or creative strategy layer.

Required Setup

• a Shorts V2 account with an API key from /api-keys
• at least one connected channel in /channels
• credits available before creating schedules
• for TikTok slideshow inbox posting, local uploads or public image URLs that Shorts V2 can normalize and publish

Authentication

X-API-Key: sk_v2_...

Base URL

https://shortsblink.com

Standard Execution Flow

1. list channels and pick the right one
2. create a schedule with uploaded files or asset URLs
3. publish immediately when needed
4. if TikTok returns a non-terminal state like PROCESSING_DOWNLOAD, poll the status endpoint
5. stop only when the terminal state is positive or failed

Call Sequence

GET  /api/v2/channels
POST /api/v2/schedules
POST /api/v2/schedules/{schedule_id}/publish
GET  /api/v2/schedules/{schedule_id}/status

Channel Lookup

curl https://shortsblink.com/api/v2/channels \
  -H "X-API-Key: sk_v2_..."

Create A Schedule With Multipart Upload

curl https://shortsblink.com/api/v2/schedules \
  -H "X-API-Key: sk_v2_..." \
  -F "channel_id=4" \
  -F "title=TikTok slideshow" \
  -F "caption=Uploaded by Shorts V2 skill" \
  -F "scheduled_for=2026-04-11T15:00:00Z" \
  -F "content_type=slideshow" \
  -F "delivery_mode=inbox" \
  -F "assets=@slide1.png" \
  -F "assets=@slide2.png"

Publish Immediately

curl -X POST https://shortsblink.com/api/v2/schedules/SCHEDULE_ID/publish \
  -H "X-API-Key: sk_v2_..."

Refresh TikTok Status

curl https://shortsblink.com/api/v2/schedules/SCHEDULE_ID/status \
  -H "X-API-Key: sk_v2_..."

TikTok Inbox Interpretation

• PROCESSING_DOWNLOAD: TikTok accepted the upload but is still processing it
• SEND_TO_USER_INBOX: positive inbox-confirmed state
• FAILED: terminal failure; inspect fail_reason

Example Positive Response

{
  "status": "uploaded",
  "schedule": {
    "publish_result": {
      "publish_status": {
        "data": {
          "status": "SEND_TO_USER_INBOX"
        }
      },
      "inbox_status": "sent_to_user_inbox"
    }
  }
}

Example Failure Response

{
  "status": "failed",
  "schedule": {
    "publish_result": {
      "publish_status": {
        "data": {
          "status": "FAILED",
          "fail_reason": "file_format_check_failed"
        }
      }
    }
  }
}

Media Handling Rules

• TikTok slideshow uploads only accept TikTok-safe image formats in the final publish step.
• Shorts V2 converts unsupported local slideshow image formats such as PNG into JPEG publish assets.
• The publish response can still be intermediate even after the upload succeeds.
• Do not claim success until the status endpoint reaches a terminal state.

How To Recover From Credit Errors

Creating a schedule costs 1 credit. If the API returns a credit error, the schedule was not created.

1. Open https://shortsblink.com/plans
2. Buy a credit pack or redeem a coupon
3. Retry the same schedule creation request

Admin coupon management is available at /admin/coupons for the authorized admin account.

Common Failure Cases

• 402: insufficient credits
• 400: invalid channel id or invalid payload
• FAILED with fail_reason: TikTok rejected the upload
• stuck in PROCESSING_DOWNLOAD: keep polling the status endpoint
• missing TikTok drafts: confirm the terminal state before treating the upload as complete