Multi Upload Tool Pools API
Queues of media drip-fed to accounts.
Queues of media drip-fed to accounts.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
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.curl "https://apis.io/api/v1/apis/multi-upload-tool-com:multi-upload-tool-com-pools-api"
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.
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: 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