late-sdk 0.0.103 → 0.0.104

data/openapi.yaml

@@ -200,14 +200,6 @@ tags:
     description: |
       X/Twitter-specific engagement endpoints for retweeting, bookmarking, and following.
       Rate limits: 50 requests per 15-min window per user. Retweets share the 300/3hr creation limit with tweet creation.
-  - name: Tools
-    description: |
-      Media download and utility tools. Available to paid plans only.
-      Rate limits: Build (50/day), Accelerate (500/day), Unlimited (unlimited).
-      All responses include X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset headers.
-  - name: Validate
-    description: |
-      Pre-flight validation endpoints. Check post content, character limits, media URLs, and subreddit existence before publishing.
   - name: Account Settings
     description: |
       Platform-specific account settings: Facebook persistent menu, Instagram ice breakers, and Telegram bot commands.
@@ -2528,79 +2520,6 @@ components:
           format: date-time
         timezone:
           type: string
-    # Tools Responses
-    DownloadFormat:
-      type: object
-      properties:
-        formatId:
-          type: string
-        ext:
-          type: string
-        resolution:
-          type: string
-        filesize:
-          type: integer
-        quality:
-          type: string
-    DownloadResponse:
-      type: object
-      properties:
-        url:
-          type: string
-          format: uri
-        title:
-          type: string
-        thumbnail:
-          type: string
-          format: uri
-        duration:
-          type: integer
-        formats:
-          type: array
-          items:
-            $ref: '#/components/schemas/DownloadFormat'
-    TranscriptSegment:
-      type: object
-      properties:
-        text:
-          type: string
-        start:
-          type: number
-        duration:
-          type: number
-    TranscriptResponse:
-      type: object
-      properties:
-        transcript:
-          type: string
-        segments:
-          type: array
-          items:
-            $ref: '#/components/schemas/TranscriptSegment'
-        language:
-          type: string
-    HashtagInfo:
-      type: object
-      properties:
-        hashtag:
-          type: string
-        status:
-          type: string
-          enum: [safe, banned, restricted, unknown]
-        postCount:
-          type: integer
-    HashtagCheckResponse:
-      type: object
-      properties:
-        hashtags:
-          type: array
-          items:
-            $ref: '#/components/schemas/HashtagInfo'
-    CaptionResponse:
-      type: object
-      properties:
-        caption:
-          type: string
     # Users Responses
     User:
       type: object
@@ -2866,656 +2785,7 @@ webhooks:
 security:
   - bearerAuth: []
 paths:
-  # ============================================
-  # Tools API - Media Download & Utilities
-  # ============================================
-  /v1/tools/youtube/download:
-    get:
-      operationId: downloadYouTubeVideo
-      tags: [Tools]
-      summary: Download YouTube video
-      description: |
-        Download YouTube videos or audio. Returns available formats or direct download URL.
-        
-        Rate limits: Build (50/day), Accelerate (500/day), Unlimited (unlimited).
-      security:
-        - bearerAuth: []
-      parameters:
-        - name: url
-          in: query
-          required: true
-          description: YouTube video URL or video ID
-          schema:
-            type: string
-            example: "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
-        - name: action
-          in: query
-          description: "Action to perform: 'download' returns download URL, 'formats' lists available formats"
-          schema:
-            type: string
-            enum: [download, formats]
-            default: download
-        - name: format
-          in: query
-          description: Desired format (when action=download)
-          schema:
-            type: string
-            enum: [video, audio]
-            default: video
-        - name: quality
-          in: query
-          description: Desired quality (when action=download)
-          schema:
-            type: string
-            enum: [hd, sd]
-            default: hd
-        - name: formatId
-          in: query
-          description: Specific format ID from formats list
-          schema:
-            type: string
-      responses:
-        "200":
-          description: Success
-          headers:
-            X-RateLimit-Limit:
-              schema: { type: string }
-              description: Daily rate limit
-            X-RateLimit-Remaining:
-              schema: { type: string }
-              description: Remaining calls today
-            X-RateLimit-Reset:
-              schema: { type: string }
-              description: Unix timestamp when limit resets
-          content:
-            application/json:
-              schema:
-                type: object
-                properties:
-                  success: { type: boolean }
-                  title: { type: string }
-                  downloadUrl: { type: string, format: uri }
-                  formats:
-                    type: array
-                    items:
-                      type: object
-                      properties:
-                        id: { type: string }
-                        label: { type: string }
-                        ext: { type: string }
-                        type: { type: string }
-                        height: { type: integer }
-                        width: { type: integer }
-        "401":
-          $ref: '#/components/responses/Unauthorized'
-        "403":
-          description: Tools API not available on free plan
-        "429":
-          description: Daily rate limit exceeded
-
-  /v1/tools/youtube/transcript:
-    get:
-      operationId: getYouTubeTranscript
-      tags: [Tools]
-      summary: Get YouTube transcript
-      description: |
-        Extract transcript/captions from a YouTube video.
-        
-        Rate limits: Build (50/day), Accelerate (500/day), Unlimited (unlimited).
-      security:
-        - bearerAuth: []
-      parameters:
-        - name: url
-          in: query
-          required: true
-          description: YouTube video URL or video ID
-          schema:
-            type: string
-        - name: lang
-          in: query
-          description: Language code for transcript
-          schema:
-            type: string
-            default: en
-      responses:
-        "200":
-          description: Success
-          content:
-            application/json:
-              schema:
-                type: object
-                properties:
-                  success: { type: boolean }
-                  videoId: { type: string }
-                  language: { type: string }
-                  fullText: { type: string }
-                  segments:
-                    type: array
-                    items:
-                      type: object
-                      properties:
-                        text: { type: string }
-                        start: { type: number }
-                        duration: { type: number }
-        "404":
-          description: No transcript available
-        "503":
-          description: Transcript service temporarily unavailable
-
-  /v1/tools/instagram/download:
-    get:
-      operationId: downloadInstagramMedia
-      tags: [Tools]
-      summary: Download Instagram media
-      description: |
-        Download Instagram reels, posts, or photos.
-        
-        Rate limits: Build (50/day), Accelerate (500/day), Unlimited (unlimited).
-      security:
-        - bearerAuth: []
-      parameters:
-        - name: url
-          in: query
-          required: true
-          description: Instagram reel or post URL
-          schema:
-            type: string
-            example: "https://www.instagram.com/reel/ABC123/"
-      responses:
-        "200":
-          description: Success
-          content:
-            application/json:
-              schema:
-                type: object
-                properties:
-                  success: { type: boolean }
-                  title: { type: string }
-                  downloadUrl: { type: string, format: uri }
-
-  /v1/tools/instagram/hashtag-checker:
-    post:
-      operationId: checkInstagramHashtags
-      tags: [Tools]
-      summary: Check IG hashtag bans
-      description: |
-        Check if Instagram hashtags are banned, restricted, or safe to use.
-        
-        Rate limits: Build (50/day), Accelerate (500/day), Unlimited (unlimited).
-      security:
-        - bearerAuth: []
-      requestBody:
-        required: true
-        content:
-          application/json:
-            schema:
-              type: object
-              required: [hashtags]
-              properties:
-                hashtags:
-                  type: array
-                  maxItems: 20
-                  items:
-                    type: string
-                  example: ["travel", "followforfollow", "fitness"]
-      responses:
-        "200":
-          description: Success
-          content:
-            application/json:
-              schema:
-                type: object
-                properties:
-                  success: { type: boolean }
-                  results:
-                    type: array
-                    items:
-                      type: object
-                      properties:
-                        hashtag: { type: string }
-                        status:
-                          type: string
-                          enum: [banned, restricted, safe, unknown]
-                        reason: { type: string }
-                        confidence: { type: number }
-                  summary:
-                    type: object
-                    properties:
-                      banned: { type: integer }
-                      restricted: { type: integer }
-                      safe: { type: integer }
-
-  /v1/tools/tiktok/download:
-    get:
-      operationId: downloadTikTokVideo
-      tags: [Tools]
-      summary: Download TikTok video
-      description: |
-        Download TikTok videos with or without watermark.
-        
-        Rate limits: Build (50/day), Accelerate (500/day), Unlimited (unlimited).
-      security:
-        - bearerAuth: []
-      parameters:
-        - name: url
-          in: query
-          required: true
-          description: TikTok video URL or ID
-          schema:
-            type: string
-        - name: action
-          in: query
-          description: "'formats' to list available formats"
-          schema:
-            type: string
-            enum: [download, formats]
-            default: download
-        - name: formatId
-          in: query
-          description: Specific format ID (0 = no watermark, etc.)
-          schema:
-            type: string
-      responses:
-        "200":
-          description: Success
-          content:
-            application/json:
-              schema:
-                type: object
-                properties:
-                  success: { type: boolean }
-                  title: { type: string }
-                  downloadUrl: { type: string, format: uri }
-                  formats:
-                    type: array
-                    items:
-                      type: object
-                      properties:
-                        id: { type: string }
-                        label: { type: string }
-                        ext: { type: string }
-
-  /v1/tools/twitter/download:
-    get:
-      operationId: downloadTwitterMedia
-      tags: [Tools]
-      summary: Download Twitter/X media
-      description: |
-        Download videos from Twitter/X posts.
-        
-        Rate limits: Build (50/day), Accelerate (500/day), Unlimited (unlimited).
-      security:
-        - bearerAuth: []
-      parameters:
-        - name: url
-          in: query
-          required: true
-          description: Twitter/X post URL
-          schema:
-            type: string
-            example: "https://x.com/user/status/123456789"
-        - name: action
-          in: query
-          schema:
-            type: string
-            enum: [download, formats]
-            default: download
-        - name: formatId
-          in: query
-          schema:
-            type: string
-      responses:
-        "200":
-          description: Success
-          content:
-            application/json:
-              schema:
-                type: object
-                properties:
-                  success: { type: boolean }
-                  title: { type: string }
-                  downloadUrl: { type: string, format: uri }
-
-  /v1/tools/facebook/download:
-    get:
-      operationId: downloadFacebookVideo
-      tags: [Tools]
-      summary: Download Facebook video
-      description: |
-        Download videos and reels from Facebook.
-        
-        Rate limits: Build (50/day), Accelerate (500/day), Unlimited (unlimited).
-      security:
-        - bearerAuth: []
-      parameters:
-        - name: url
-          in: query
-          required: true
-          description: Facebook video or reel URL
-          schema:
-            type: string
-      responses:
-        "200":
-          description: Success
-          content:
-            application/json:
-              schema:
-                type: object
-                properties:
-                  success: { type: boolean }
-                  title: { type: string }
-                  downloadUrl: { type: string, format: uri }
-                  thumbnail: { type: string, format: uri }
-
-  /v1/tools/linkedin/download:
-    get:
-      operationId: downloadLinkedInVideo
-      tags: [Tools]
-      summary: Download LinkedIn video
-      description: |
-        Download videos from LinkedIn posts.
-        
-        Rate limits: Build (50/day), Accelerate (500/day), Unlimited (unlimited).
-      security:
-        - bearerAuth: []
-      parameters:
-        - name: url
-          in: query
-          required: true
-          description: LinkedIn post URL
-          schema:
-            type: string
-      responses:
-        "200":
-          description: Success
-          content:
-            application/json:
-              schema:
-                type: object
-                properties:
-                  success: { type: boolean }
-                  title: { type: string }
-                  downloadUrl: { type: string, format: uri }
-
-  /v1/tools/bluesky/download:
-    get:
-      operationId: downloadBlueskyMedia
-      tags: [Tools]
-      summary: Download Bluesky media
-      description: |
-        Download videos from Bluesky posts.
-        
-        Rate limits: Build (50/day), Accelerate (500/day), Unlimited (unlimited).
-      security:
-        - bearerAuth: []
-      parameters:
-        - name: url
-          in: query
-          required: true
-          description: Bluesky post URL
-          schema:
-            type: string
-            example: "https://bsky.app/profile/user.bsky.social/post/abc123"
-      responses:
-        "200":
-          description: Success
-          content:
-            application/json:
-              schema:
-                type: object
-                properties:
-                  success: { type: boolean }
-                  title: { type: string }
-                  text: { type: string }
-                  downloadUrl: { type: string, format: uri }
-                  thumbnail: { type: string, format: uri }
-
-  # ============================================
-  # Validate
-  # ============================================
-  /v1/tools/validate/post-length:
-    post:
-      operationId: validatePostLength
-      tags: [Validate]
-      summary: Validate post character count
-      description: |
-        Check weighted character count per platform and whether the text is within each platform's limit.
-
-        Twitter/X uses weighted counting (URLs = 23 chars via t.co, emojis = 2 chars). All other platforms use plain character length.
-
-        Returns counts and limits for all 15 supported platform variants.
-      security:
-        - bearerAuth: []
-      requestBody:
-        required: true
-        content:
-          application/json:
-            schema:
-              type: object
-              required: [text]
-              properties:
-                text:
-                  type: string
-                  description: The post text to check
-                  example: "Check out https://zernio.com for scheduling posts!"
-      responses:
-        "200":
-          description: Character counts per platform
-          content:
-            application/json:
-              schema:
-                type: object
-                properties:
-                  text: { type: string }
-                  platforms:
-                    type: object
-                    additionalProperties:
-                      type: object
-                      properties:
-                        count: { type: integer, description: "Character count for this platform" }
-                        limit: { type: integer, description: "Maximum allowed characters" }
-                        valid: { type: boolean, description: "Whether the text is within the limit" }
-                    example:
-                      twitter: { count: 51, limit: 280, valid: true }
-                      twitterPremium: { count: 51, limit: 25000, valid: true }
-                      instagram: { count: 51, limit: 2200, valid: true }
-                      bluesky: { count: 51, limit: 300, valid: true }
-                      snapchat: { count: 51, limit: 160, valid: true }
-
-  /v1/tools/validate/post:
-    post:
-      operationId: validatePost
-      tags: [Validate]
-      summary: Validate post content
-      description: |
-        Dry-run the full post validation pipeline without publishing. Catches issues like missing media for Instagram/TikTok/YouTube, hashtag limits, invalid thread formats, Facebook Reel requirements, and character limit violations.
-
-        Accepts the same body as `POST /v1/posts`. Does NOT validate accounts, process media, or track usage. This is content-only validation.
-
-        Returns errors for failures and warnings for near-limit content (>90% of character limit).
-      security:
-        - bearerAuth: []
-      requestBody:
-        required: true
-        content:
-          application/json:
-            schema:
-              type: object
-              required: [platforms]
-              properties:
-                content:
-                  type: string
-                  description: Post text content
-                  example: "Check out this video!"
-                platforms:
-                  type: array
-                  description: Target platforms (same format as POST /v1/posts)
-                  items:
-                    type: object
-                    required: [platform]
-                    properties:
-                      platform:
-                        type: string
-                        enum: [twitter, instagram, tiktok, youtube, facebook, linkedin, bluesky, threads, reddit, pinterest, telegram, snapchat, googlebusiness]
-                      customContent: { type: string }
-                      platformSpecificData: { type: object }
-                      customMedia:
-                        type: array
-                        items:
-                          type: object
-                          properties:
-                            url: { type: string }
-                            type: { type: string, enum: [image, video] }
-                  example:
-                    - platform: youtube
-                    - platform: twitter
-                mediaItems:
-                  type: array
-                  description: Root media items shared across platforms
-                  items:
-                    type: object
-                    properties:
-                      url: { type: string, format: uri }
-                      type: { type: string, enum: [image, video] }
-      responses:
-        "200":
-          description: Validation result
-          content:
-            application/json:
-              schema:
-                oneOf:
-                  - type: object
-                    description: Valid post
-                    properties:
-                      valid: { type: boolean }
-                      message: { type: string, example: "No validation issues found." }
-                      warnings:
-                        type: array
-                        items:
-                          type: object
-                          properties:
-                            platform: { type: string }
-                            warning: { type: string }
-                  - type: object
-                    description: Invalid post
-                    properties:
-                      valid: { type: boolean }
-                      errors:
-                        type: array
-                        items:
-                          type: object
-                          properties:
-                            platform: { type: string }
-                            error: { type: string }
-                      warnings:
-                        type: array
-                        items:
-                          type: object
-                          properties:
-                            platform: { type: string }
-                            warning: { type: string }
-
-  /v1/tools/validate/media:
-    post:
-      operationId: validateMedia
-      tags: [Validate]
-      summary: Validate media URL
-      description: |
-        Check if a media URL is accessible and return metadata (content type, file size) plus per-platform size limit comparisons.
-
-        Performs a HEAD request (with GET fallback) to detect content type and size. Rejects private/localhost URLs for SSRF protection.
-
-        Platform limits are sourced from each platform's actual upload constraints.
-      security:
-        - bearerAuth: []
-      requestBody:
-        required: true
-        content:
-          application/json:
-            schema:
-              type: object
-              required: [url]
-              properties:
-                url:
-                  type: string
-                  format: uri
-                  description: Public media URL to validate
-                  example: "https://example.com/image.jpg"
-      responses:
-        "200":
-          description: Media validation result
-          content:
-            application/json:
-              schema:
-                type: object
-                properties:
-                  valid: { type: boolean }
-                  url: { type: string, format: uri }
-                  error: { type: string, description: "Error message if valid is false" }
-                  contentType: { type: string, example: "image/jpeg" }
-                  size: { type: integer, nullable: true, description: "File size in bytes" }
-                  sizeFormatted: { type: string, example: "245 KB" }
-                  type: { type: string, enum: [image, video, unknown] }
-                  platformLimits:
-                    type: object
-                    description: Per-platform size limit comparison (only present when size and type are known)
-                    additionalProperties:
-                      type: object
-                      properties:
-                        limit: { type: integer, description: "Platform size limit in bytes" }
-                        limitFormatted: { type: string }
-                        withinLimit: { type: boolean }
-                    example:
-                      instagram: { limit: 8388608, limitFormatted: "8.0 MB", withinLimit: true }
-                      twitter: { limit: 5242880, limitFormatted: "5.0 MB", withinLimit: true }
-                      bluesky: { limit: 1000000, limitFormatted: "977 KB", withinLimit: true }
-
-  /v1/tools/validate/subreddit:
-    get:
-      operationId: validateSubreddit
-      tags: [Validate]
-      summary: Check subreddit existence
-      description: |
-        Check if a subreddit exists and return basic info (title, subscriber count, NSFW status, post types allowed).
-
-        Uses Reddit's public JSON API (no Reddit auth needed). Returns `exists: false` for private, banned, or nonexistent subreddits.
-      security:
-        - bearerAuth: []
-      parameters:
-        - name: name
-          in: query
-          required: true
-          description: Subreddit name (with or without "r/" prefix)
-          schema:
-            type: string
-            example: "programming"
-      responses:
-        "200":
-          description: Subreddit lookup result
-          content:
-            application/json:
-              schema:
-                oneOf:
-                  - type: object
-                    description: Subreddit exists
-                    properties:
-                      exists: { type: boolean }
-                      subreddit:
-                        type: object
-                        properties:
-                          name: { type: string, example: "programming" }
-                          title: { type: string, example: "programming" }
-                          description: { type: string, example: "Computer Programming" }
-                          subscribers: { type: integer, example: 6844284 }
-                          isNSFW: { type: boolean }
-                          type: { type: string, enum: [public, private, restricted], example: "public" }
-                          allowImages: { type: boolean }
-                          allowVideos: { type: boolean }
-                  - type: object
-                    description: Subreddit not found
-                    properties:
-                      exists: { type: boolean }
-                      error: { type: string }
+  # NOTE: Tools & Validate endpoints (/v1/tools/*) removed from docs but still functional for existing customers
 
   # ============================================
   # Analytics