Multi Upload Tool Short links API

Trackable short links with routing rules.

GitHub OpenAPI

Operations 5

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-short-links-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-short-links-api-openapi.yml Raw ↑
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