Multi Upload Tool Pools API

Queues of media drip-fed to accounts.

GitHub OpenAPI

Operations 8

GET /pools List pools #
GET /pools/{id} Get a pool #
GET /pools/{id}/capacity Get remaining pool capacity #
GET /pools/{id}/videos List media in a pool #
POST /pools/{id}/videos Add media to a pool #
DELETE /pools/{id}/videos Empty a pool #
POST /pools/{id}/videos/bulk Add several media items to a pool #
DELETE /pools/{id}/videos/{itemId} Remove one item from a pool #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/multi-upload-tool-com:multi-upload-tool-com-pools-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

multi-upload-tool-com-pools-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Multi Upload Tool Pools API
  version: 1.0.0
  summary: Publish and schedule video and photo posts to TikTok, YouTube, Instagram, Facebook, LinkedIn, Pinterest, Bluesky and Threads from one API.
  description: 'REST API for the Multi Upload Tool platform.


    Upload a video or photo once and publish it to one or many connected social accounts, immediately or on a schedule. The API also covers connected-account management, upload history, per-account daily limits, webhooks, teams, white-label connection links, short links and custom domains.


    ## Authentication


    Every endpoint requires an API token sent in the `x-api-key` header. Tokens are created from the dashboard and look like `kmb_`.


    ```

    x-api-key: kmb_0123456789abcdef...

    ```


    ## Permission model


    A token carries **scopes**, chosen when it is created in the dashboard. `*` grants everything: it is what every token created before scopes existed holds, and what a token created without a list gets. Otherwise the token holds `resource:action` scopes — `posts:read`, `posts:write`, `posts:publish`, `accounts:read`, `accounts:write`, `analytics:read`, `pools:read`, `pools:write`, `webhooks:read`, `webhooks:write`, `team:read`, `team:write`, `links:read`, `links:write`. `write` includes `read`, and `posts:publish` includes `posts:write`. A token with `posts:write` but not `posts:publish` can create posts, but they are always held for approval. Each operation states what it needs in `x-required-scope`; a call without it returns `403` with `code: INSUFFICIENT_SCOPE` and `requiredScope`.


    On top of scopes, **team scoping** applies.


    - A token created against a team is permanently pinned to that team. It can only read and write that team''s resources, and it is revoked automatically if the user leaves the team.

    - An unscoped token may target a team per-request with the `X-Team-ID` header. Membership is verified on every call.

    - Inside a team, the member''s role (`OWNER`, `ADMIN`, `MEMBER`) gates privileged operations. Members cannot create webhooks; only owners and admins can invite or remove members; only an owner can remove an admin.


    Treat an API token as a credential and store it accordingly; give each integration only the scopes it needs.


    ## Large media


    A file part sent to `POST /upload` must stay under 100 MB, an edge limit on the request body rather than a platform one. For anything larger, call `POST /upload/presign` to get URLs that put the bytes straight into storage, then publish by passing the returned `bucketUrl` (preferred for large video) or `accessUrl` in the `video`, `photo` or `file` field.


    ## Rate limits


    Limits are applied per IP and per endpoint group; exceeding one returns `429`. The tightest limits are on writes: 50 requests / 15 min for `POST /upload`, 20 requests / 15 min for `POST /upload/bulk` and for destructive operations. Reads are typically 100 requests / 5-15 min. A single IP may also present at most 10 distinct API tokens per hour.


    ## Errors


    Errors return a JSON body of the form `{ "success": false, "error": "..." }`. Validation failures on `POST /upload` additionally return a per-field `errors` array.'
  termsOfService: https://multi-upload-tool.com/terms
  contact:
    name: Multi Upload Tool support
    url: https://multi-upload-tool.com/about
    email: support@multi-upload-tool.com
servers:
- url: https://api.multi-upload-tool.com/api/v1
  description: Production
security:
- apiKey: []
tags:
- name: Pools
  description: Queues of media drip-fed to accounts.
paths:
  /pools:
    get:
      tags:
      - Pools
      summary: List pools
      description: Pools hold media that is published to their attached accounts on a recurring schedule.
      operationId: listPools
      x-required-scope: pools:read
      parameters:
      - $ref: '#/components/parameters/TeamId'
      responses:
        '200':
          description: The caller's pools.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    const: true
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/Pool'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '429':
          $ref: '#/components/responses/RateLimited'
  /pools/{id}:
    get:
      tags:
      - Pools
      summary: Get a pool
      description: Returns one pool and its current state.
      operationId: getPool
      x-required-scope: pools:read
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      - $ref: '#/components/parameters/TeamId'
      responses:
        '200':
          description: The pool.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    const: true
                  data:
                    $ref: '#/components/schemas/Pool'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
  /pools/{id}/capacity:
    get:
      tags:
      - Pools
      summary: Get remaining pool capacity
      description: Returns how much more media the pool can accept before it hits its configured ceiling.
      operationId: getPoolCapacity
      x-required-scope: pools:read
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      - $ref: '#/components/parameters/TeamId'
      responses:
        '200':
          description: The pool's capacity.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    const: true
                  data:
                    type: object
                    additionalProperties: true
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
  /pools/{id}/videos:
    parameters:
    - name: id
      in: path
      required: true
      schema:
        type: string
    - $ref: '#/components/parameters/TeamId'
    get:
      tags:
      - Pools
      summary: List media in a pool
      description: Returns the media currently queued in the pool.
      operationId: listPoolVideos
      x-required-scope: pools:read
      responses:
        '200':
          description: The pool's queued media.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    const: true
                  data:
                    type: array
                    items:
                      type: object
                      additionalProperties: true
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
    post:
      tags:
      - Pools
      summary: Add media to a pool
      description: Adds one media file to the pool's queue.
      operationId: addPoolVideo
      x-required-scope: pools:write
      requestBody:
        required: true
        content:
          multipart/form-data:
            schema:
              type: object
              properties:
                video:
                  type: string
                  format: binary
                title:
                  type: string
                description:
                  type: string
      responses:
        '200':
          $ref: '#/components/responses/Success'
        '400':
          $ref: '#/components/responses/ValidationError'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
    delete:
      tags:
      - Pools
      summary: Empty a pool
      description: Removes every queued item from the pool.
      operationId: clearPoolVideos
      x-required-scope: pools:write
      responses:
        '200':
          $ref: '#/components/responses/Success'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
  /pools/{id}/videos/bulk:
    post:
      tags:
      - Pools
      summary: Add several media items to a pool
      description: Adds several media files to the pool's queue in one request.
      operationId: addPoolVideosBulk
      x-required-scope: pools:write
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      - $ref: '#/components/parameters/TeamId'
      requestBody:
        required: true
        content:
          multipart/form-data:
            schema:
              type: object
              properties:
                videos:
                  type: array
                  items:
                    type: string
                    format: binary
      responses:
        '200':
          $ref: '#/components/responses/Success'
        '400':
          $ref: '#/components/responses/ValidationError'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
  /pools/{id}/videos/{itemId}:
    delete:
      tags:
      - Pools
      summary: Remove one item from a pool
      description: Removes one queued item without touching the rest of the pool.
      operationId: deletePoolVideo
      x-required-scope: pools:write
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      - name: itemId
        in: path
        required: true
        schema:
          type: string
      - $ref: '#/components/parameters/TeamId'
      responses:
        '200':
          $ref: '#/components/responses/Success'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
components:
  responses:
    NotFound:
      description: No such resource, or it does not belong to the caller.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Success:
      description: The operation succeeded.
      content:
        application/json:
          schema:
            type: object
            properties:
              success:
                const: true
              message:
                type: string
    ValidationError:
      description: The request body or parameters were rejected.
      content:
        application/json:
          schema:
            oneOf:
            - $ref: '#/components/schemas/Error'
            - $ref: '#/components/schemas/FieldValidationError'
    Unauthorized:
      description: The API key is missing, invalid, revoked or expired.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    RateLimited:
      description: Too many requests for this endpoint group.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  parameters:
    TeamId:
      name: X-Team-ID
      in: header
      required: false
      description: Act inside this team. Ignored when the token is already pinned to a team; membership is verified on every request.
      schema:
        type: integer
  schemas:
    FieldValidationError:
      type: object
      required:
      - success
      - message
      - errors
      properties:
        success:
          const: false
        message:
          const: Validation Error
        errors:
          type: array
          items:
            type: object
            properties:
              path:
                type: string
              message:
                type: string
              summary:
                type: string
    Pool:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
        isActive:
          type: boolean
        itemCount:
          type: integer
        staggerMinutes:
          type: integer
          minimum: 0
          maximum: 60
          description: Each slot's accounts go out at random moments spread over this many minutes instead of all at the slot time. 0 = off. Set in the app; always shorter than the gap to the next slot.
    Error:
      type: object
      required:
      - success
      - error
      properties:
        success:
          const: false
        error:
          type: string
          description: Human-readable failure reason.
        statusCode:
          type: integer
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: x-api-key
      description: 'API token created from the dashboard, in the form `kmb_<64 hex characters>`.


        A token carries a list of scopes, chosen when it is created: `*` (everything — every token created before scopes existed, and any token created without a list) or `resource:action` scopes such as `posts:read` or `analytics:read`. Each operation states the scope it needs in `x-required-scope`; a token without it gets `403` with `code: INSUFFICIENT_SCOPE`. A token with `posts:write` but not `posts:publish` can create posts, which are always held for approval. On top of scopes, team scoping applies: baked into the token at creation time or requested per-call with `X-Team-ID`. Store it as you would a password.'
externalDocs:
  description: Full API documentation
  url: https://docs.multi-upload-tool.com/api-reference