Multi Upload Tool Short links API
Trackable short links with routing rules.
Trackable short links with routing rules.
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-short-links-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 Short links 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: Short links
description: Trackable short links with routing rules.
paths:
/short-links:
get:
tags:
- Short links
summary: List short links
description: Returns the caller's short links with their click counts.
operationId: listShortLinks
x-required-scope: links:read
parameters:
- $ref: '#/components/parameters/TeamId'
- name: page
in: query
required: false
schema:
type: integer
minimum: 1
- name: limit
in: query
required: false
schema:
type: integer
minimum: 1
responses:
'200':
description: The caller's short links.
content:
application/json:
schema:
type: object
properties:
success:
const: true
data:
type: array
items:
$ref: '#/components/schemas/ShortLink'
'401':
$ref: '#/components/responses/Unauthorized'
'429':
$ref: '#/components/responses/RateLimited'
post:
tags:
- Short links
summary: Create a short link
description: Creates a trackable short link, optionally with routing rules that send different visitors to different destinations.
operationId: createShortLink
x-required-scope: links:write
parameters:
- $ref: '#/components/parameters/TeamId'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/ShortLinkRequest'
responses:
'200':
description: The created short link, including its full URL.
content:
application/json:
schema:
type: object
properties:
success:
const: true
data:
$ref: '#/components/schemas/ShortLink'
'400':
$ref: '#/components/responses/ValidationError'
'401':
$ref: '#/components/responses/Unauthorized'
'429':
$ref: '#/components/responses/RateLimited'
/short-links/{id}:
parameters:
- name: id
in: path
required: true
schema:
type: integer
- $ref: '#/components/parameters/TeamId'
get:
tags:
- Short links
summary: Get a short link
description: Returns one short link together with its routing rules.
operationId: getShortLink
x-required-scope: links:read
responses:
'200':
description: The short link and its routing rules.
content:
application/json:
schema:
type: object
properties:
success:
const: true
data:
$ref: '#/components/schemas/ShortLink'
'401':
$ref: '#/components/responses/Unauthorized'
'404':
$ref: '#/components/responses/NotFound'
'429':
$ref: '#/components/responses/RateLimited'
put:
tags:
- Short links
summary: Update a short link
description: Replaces the link's details and routing rules.
operationId: updateShortLink
x-required-scope: links:write
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/ShortLinkRequest'
responses:
'200':
description: The updated short link.
content:
application/json:
schema:
type: object
properties:
success:
const: true
data:
$ref: '#/components/schemas/ShortLink'
'400':
$ref: '#/components/responses/ValidationError'
'401':
$ref: '#/components/responses/Unauthorized'
'404':
$ref: '#/components/responses/NotFound'
'429':
$ref: '#/components/responses/RateLimited'
delete:
tags:
- Short links
summary: Delete a short link
description: Deletes the short link; its slug stops resolving.
operationId: deleteShortLink
x-required-scope: links:write
responses:
'200':
$ref: '#/components/responses/Success'
'401':
$ref: '#/components/responses/Unauthorized'
'404':
$ref: '#/components/responses/NotFound'
'429':
$ref: '#/components/responses/RateLimited'
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:
ShortLink:
type: object
properties:
id:
type: integer
slug:
type: string
url:
type: string
format: uri
shortUrl:
type: string
format: uri
description: The full short URL, on the default or custom domain.
title:
type:
- string
- 'null'
description:
type:
- string
- 'null'
imageUrl:
type:
- string
- 'null'
format: uri
domainId:
type:
- integer
- 'null'
useDeeplink:
type: boolean
botProtection:
type: boolean
safeUrl:
type:
- string
- 'null'
format: uri
clicks:
type: integer
rules:
type: array
items:
$ref: '#/components/schemas/ShortLinkRule'
createdAt:
type: string
format: date-time
ShortLinkRule:
type: object
description: Sends a subset of visitors to a different destination. Rules are evaluated by descending priority.
required:
- type
- destination
properties:
type:
type: string
enum:
- geo
- device
- language
- time
- referer
destination:
type: string
format: uri
countryCodes:
type: string
maxLength: 500
description: Comma-separated ISO 3166-1 alpha-2 codes.
languages:
type: string
maxLength: 500
devices:
type: string
maxLength: 500
referers:
type: string
maxLength: 1000
startTime:
type: string
endTime:
type: string
days:
type: string
timezone:
type: string
maxLength: 50
priority:
type: integer
minimum: 0
maximum: 1000
useDeeplink:
type: boolean
isActive:
type: boolean
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
Error:
type: object
required:
- success
- error
properties:
success:
const: false
error:
type: string
description: Human-readable failure reason.
statusCode:
type: integer
ShortLinkRequest:
type: object
required:
- url
properties:
url:
type: string
format: uri
description: Default destination.
slug:
type: string
minLength: 1
maxLength: 150
pattern: ^[a-zA-Z0-9-_.]+$
description: Custom path. Generated when omitted.
domainId:
type: integer
description: Custom domain to serve the link from.
title:
type: string
maxLength: 200
description:
type: string
maxLength: 1000
imageUrl:
type: string
format: uri
maxLength: 2048
useDeeplink:
type: boolean
description: Open the destination in the target app rather than a browser.
botProtection:
type: boolean
description: Send detected bots to `safeUrl` instead.
safeUrl:
type: string
format: uri
maxLength: 2048
rules:
type: array
maxItems: 50
items:
$ref: '#/components/schemas/ShortLinkRule'
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