Multi Upload Tool Domains API

Custom domains for short links.

GitHub OpenAPI

Operations 4

GET /domains List custom domains #
POST /domains Add a custom domain #
DELETE /domains/{id} Delete a custom domain #
POST /domains/{id}/verify Verify a custom domain #

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-domains-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-domains-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Multi Upload Tool Domains 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: Domains
  description: Custom domains for short links.
paths:
  /domains:
    get:
      tags:
      - Domains
      summary: List custom domains
      description: Returns the custom short-link domains registered by the caller and whether each is verified.
      operationId: listDomains
      x-required-scope: links:read
      parameters:
      - $ref: '#/components/parameters/TeamId'
      responses:
        '200':
          description: The caller's custom short-link domains.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    const: true
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/Domain'
        '401':
          $ref: '#/components/responses/Unauthorized'
    post:
      tags:
      - Domains
      summary: Add a custom domain
      description: Registers a domain for short links. Point it at the platform with a CNAME, then call the verify endpoint.
      operationId: createDomain
      x-required-scope: links:write
      parameters:
      - $ref: '#/components/parameters/TeamId'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - domain
              properties:
                domain:
                  type: string
                  examples:
                  - links.example.com
                teamId:
                  type: integer
                  description: Team to attach the domain to. Must match the token's team when the token is team-scoped.
      responses:
        '200':
          description: The registered domain and the DNS record to create.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Domain'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
  /domains/{id}:
    delete:
      tags:
      - Domains
      summary: Delete a custom domain
      description: Removes the custom domain from the account.
      operationId: deleteDomain
      x-required-scope: links:write
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: integer
      - $ref: '#/components/parameters/TeamId'
      responses:
        '200':
          $ref: '#/components/responses/Success'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
  /domains/{id}/verify:
    post:
      tags:
      - Domains
      summary: Verify a custom domain
      description: Checks that the domain's DNS points at the platform and activates it.
      operationId: verifyDomain
      x-required-scope: links:write
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: integer
      - $ref: '#/components/parameters/TeamId'
      responses:
        '200':
          description: The verification result.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Domain'
        '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
    Unauthorized:
      description: The API key is missing, invalid, revoked or expired.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Forbidden:
      description: The token is valid but not permitted to act on this resource, usually because of team scoping or the caller's team role.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  schemas:
    Domain:
      type: object
      properties:
        id:
          type: integer
        domain:
          type: string
        verified:
          type: boolean
        createdAt:
          type: string
          format: date-time
    Error:
      type: object
      required:
      - success
      - error
      properties:
        success:
          const: false
        error:
          type: string
          description: Human-readable failure reason.
        statusCode:
          type: integer
  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
  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