> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mediamonster.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Remove duplicate rows

> One of each row

`POST /api/v1/run/remove-duplicate-rows` · MCP `run_skill` with `skill: "remove-duplicate-rows"`

One of each row

## What it looks like

![Remove duplicate rows — One of each row](https://mediamonster.app/skill-cards/remove-duplicate-rows.png)

## What it takes and hands back

* **Takes:** a document — as a `url`, an `upload_id`, a Vault `asset_id`, an earlier `job_id`, or a multipart `file`.
* **Hands back:** a document.

## Price

**Free.** Counts towards the free-tool runs a plan allows each day.

## Options

Send them in `options`. Anything left out takes its default.

| Option | Label | Default | Takes |
| - | - | - | - |
| `column` | Only compare | — | Text. Up to 100 characters. |

## Where it can sit in a recipe

Every step is handed what the step above it made. These are worked out from the same rule the Workbench, the API and MCP check a recipe with, over every other live skill at its default settings.

**As the first step:** it takes a document from the call.

**Above it** — by what the step above hands on:

| The step above hands on | Skills that fit | For example |
| - | - | - |
| a picture | 0 of 66 | — |
| a video | 0 of 40 | — |
| a recording | 0 of 6 | — |
| a document | 9 of 34 | [Write rows](https://docs.mediamonster.app/skills/reference/write-rows.md), [PDF to spreadsheet](https://docs.mediamonster.app/skills/reference/pdf-to-sheet.md), [Filter rows](https://docs.mediamonster.app/skills/reference/filter-rows.md), [Remove duplicate rows](https://docs.mediamonster.app/skills/reference/remove-duplicate-rows.md), and 5 more |
| the file it was given (it passes it on) | 5 of 31 | [Check for AI writing](https://docs.mediamonster.app/skills/reference/ai-text-detector.md), [Pull the text out](https://docs.mediamonster.app/skills/reference/extract-text.md), [Summarise it](https://docs.mediamonster.app/skills/reference/summarise-document.md), [Count the words](https://docs.mediamonster.app/skills/reference/word-count.md), and 1 more |

**Below it** — it hands on a document, and 19 skills can take that:

| Drawer | Skills that fit | For example |
| - | - | - |
| Fix | 2 | [Remove duplicate rows](https://docs.mediamonster.app/skills/reference/remove-duplicate-rows.md), [Check the grammar](https://docs.mediamonster.app/skills/reference/grammar-check.md) |
| Change | 9 | [Filter rows](https://docs.mediamonster.app/skills/reference/filter-rows.md), [Keep the first rows](https://docs.mediamonster.app/skills/reference/keep-first-rows.md), [Split into rows](https://docs.mediamonster.app/skills/reference/split-into-rows.md), [Add a column](https://docs.mediamonster.app/skills/reference/add-column.md), and 5 more |
| Describe | 6 | [Check for AI writing](https://docs.mediamonster.app/skills/reference/ai-text-detector.md), [Pull the text out](https://docs.mediamonster.app/skills/reference/extract-text.md), [Summarise it](https://docs.mediamonster.app/skills/reference/summarise-document.md), [Translate it](https://docs.mediamonster.app/skills/reference/translate-document.md), and 2 more |
| Finish | 2 | [Convert a document](https://docs.mediamonster.app/skills/reference/convert-document.md), [Redact personal info](https://docs.mediamonster.app/skills/reference/redact.md) |

## Price it first

Add `dry_run=true` and the call makes every check, measures the file and answers with the price — without running or charging. A test key (`mm_test_…`) is free either way.

```bash theme={"theme":{"light":"github-dark","dark":"github-dark"}}
curl "https://mediamonster.app/api/v1/run/remove-duplicate-rows?dry_run=true" \
  -H "Authorization: Bearer $MEDIAMONSTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "url": "https://example.com/brief.pdf"
}'
```

It answers `200` with `credits`, a step-by-step `breakdown`, and your `balance` after the run. See [Dry runs](https://docs.mediamonster.app/api/run-skill.md#dry-runs).

## Run it

The same code the **Copy as code** button hands out on the skill's page in the app. Swap the link for your file, or send `upload_id`, `asset_id` or `job_id` instead.

```bash curl theme={"theme":{"light":"github-dark","dark":"github-dark"}}
# Try it free with a test key (mm_test_...) from https://mediamonster.app/keys
curl https://mediamonster.app/api/v1/run/remove-duplicate-rows \
  -H "Authorization: Bearer $MEDIAMONSTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "url": "https://example.com/brief.pdf" }'
```

```typescript TypeScript (fetch) theme={"theme":{"light":"github-dark","dark":"github-dark"}}
// Try it free with a test key (mm_test_...) from https://mediamonster.app/keys
const res = await fetch("https://mediamonster.app/api/v1/run/remove-duplicate-rows", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.MEDIAMONSTER_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ url: "https://example.com/brief.pdf" }),
});
const run = await res.json();
console.log(run);
```

```typescript TypeScript (SDK) theme={"theme":{"light":"github-dark","dark":"github-dark"}}
import { Mediamonster } from "@mediamonster/sdk";

// Try it free with a test key (mm_test_...) from https://mediamonster.app/keys
const mm = new Mediamonster({ apiKey: process.env.MEDIAMONSTER_API_KEY });

const run = await mm.skills.run("remove-duplicate-rows", { url: "https://example.com/brief.pdf" });
console.log(run);
```

```python Python (requests) theme={"theme":{"light":"github-dark","dark":"github-dark"}}
import os

import requests

# Try it free with a test key (mm_test_...) from https://mediamonster.app/keys
res = requests.post(
    "https://mediamonster.app/api/v1/run/remove-duplicate-rows",
    headers={"Authorization": f"Bearer {os.environ['MEDIAMONSTER_API_KEY']}"},
    json={"url": "https://example.com/brief.pdf"},
)
print(res.json())
```

```python Python (SDK) theme={"theme":{"light":"github-dark","dark":"github-dark"}}
from mediamonster import Mediamonster

# Try it free with a test key (mm_test_...) from https://mediamonster.app/keys
# Reads MEDIAMONSTER_API_KEY from the environment.
mm = Mediamonster()

run = mm.skills.run(
    "remove-duplicate-rows",
    url="https://example.com/brief.pdf",
)
print(run)
```

```json MCP theme={"theme":{"light":"github-dark","dark":"github-dark"}}
{
  "name": "run_skill",
  "arguments": {
    "skill": "remove-duplicate-rows",
    "url": "https://example.com/brief.pdf"
  }
}
```

## See also

* [`GET /api/v1/skills/remove-duplicate-rows`](https://mediamonster.app/api/v1/skills/remove-duplicate-rows) — this skill live, with its request as JSON Schema
* [Remove duplicate rows in the app](https://mediamonster.app/skills/remove-duplicate-rows)
* [Run a skill](https://docs.mediamonster.app/api/run-skill.md) — sources, waiting, webhooks and dry runs
* [Recipes](https://docs.mediamonster.app/api/runs.md) — run this with other steps in one call


## OpenAPI

````yaml api/openapi.reference.json POST /api/v1/run/remove-duplicate-rows
openapi: 3.1.0
info:
  title: Mediamonster API
  version: v1
  summary: Run Mediamonster's skills and recipes on your files, from code.
  description: >-
    Every skill on mediamonster.app, over HTTP: the same providers, credit
    prices and plan ceilings as the Workbench.


    Send a file as a public `url`, an earlier `job_id`, a Vault `asset_id`, or a
    multipart `file`. Calls wait up to 150 seconds for the result; `wait: false`
    answers 202 at once with a `poll_url`.


    Each skill has its own operation below, with its options as a JSON Schema
    and its price under `x-mediamonster`. Recipes — a named sequence of steps —
    run through POST /api/v1/runs.


    The same catalogue is served over MCP at /api/mcp.
  contact:
    name: Mediamonster
    url: https://docs.mediamonster.app/api/overview
servers:
  - url: https://mediamonster.app
security:
  - bearer: []
tags:
  - name: Discovery
    description: What's here, open to anyone.
  - name: Account
    description: The account and workspace behind the key.
  - name: Skills
    description: The catalogue, and the generic run.
  - name: Analysis skills
    description: Skills that hand back data about the file — tags, boxes, facts, shots.
  - name: Audio skills
    description: Skills that hand back a recording.
  - name: Document skills
    description: Skills that hand back a document.
  - name: Image skills
    description: Skills that hand back a picture.
  - name: Text skills
    description: >-
      Skills that hand back words — a transcript, subtitles, copy — and leave
      the file as it was.
  - name: Video skills
    description: Skills that hand back a video.
  - name: Recipes
    description: Named sequences of steps, run on one file.
  - name: Batches
    description: >-
      The same steps once per row of a sheet, or every combination of a few
      lists.
  - name: Convert
    description: Change a file's format or size. Free.
  - name: Jobs
    description: Poll a skill run or a conversion.
  - name: Vault
    description: Your stored files.
  - name: Galleries
    description: Client galleries.
  - name: Automations
    description: >-
      Recipes that run on the clock, once or on repeat, with nobody pressing
      Run.
  - name: Uploads
    description: Files of any size your plan takes, sent straight to storage.
  - name: Webhooks
    description: >-
      Endpoints every settled job and run is posted to, and the log of each
      attempt.
externalDocs:
  url: https://docs.mediamonster.app/api/overview
paths:
  /api/v1/run/remove-duplicate-rows:
    post:
      tags:
        - Document skills
      summary: Remove duplicate rows
      description: >-
        One of each row


        Free.


        Details, and this body's JSON Schema: GET
        /api/v1/skills/remove-duplicate-rows.
      operationId: runRemoveDuplicateRows
      parameters:
        - name: dry_run
          in: query
          required: false
          description: >-
            `true` to check and price the run without running it. Same as
            `dry_run` in the body.
          schema:
            type: boolean
            default: false
        - $ref: '#/components/parameters/XRequestId'
        - $ref: '#/components/parameters/IdempotencyKey'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RunRemoveDuplicateRowsRequest'
            example:
              url: https://example.com/scan.pdf
          multipart/form-data:
            schema:
              type: object
              properties:
                file:
                  type: string
                  format: binary
                  description: The file itself.
                options:
                  type: string
                  description: >-
                    The options object as JSON — or send each option as its own
                    field.
                wait:
                  type: boolean
                  default: true
                  description: >-
                    Hold the request until the job settles (up to 150 seconds).
                    false answers 202 at once with a `poll_url`.
                webhook_url:
                  type: string
                  format: uri
                  description: >-
                    Where to POST the finished job, signed. Checked before
                    anything is charged.
                dry_run:
                  type: boolean
                  default: false
                  description: >-
                    Check everything and answer with the price, step by step,
                    instead of running. Nothing is charged, queued or stored.
                save_to_vault:
                  type: string
                  description: 'true, or {"folder": "…"} as JSON.'
              additionalProperties:
                type: string
      responses:
        '200':
          description: >-
            The job finished while the call waited — or, with `dry_run`, what it
            would cost.
          content:
            application/json:
              schema:
                oneOf:
                  - $ref: '#/components/schemas/SkillRunResult'
                  - $ref: '#/components/schemas/DryRun'
          headers:
            X-Request-Id:
              $ref: '#/components/headers/X-Request-Id'
            X-RateLimit-Limit:
              $ref: '#/components/headers/X-RateLimit-Limit'
            X-RateLimit-Remaining:
              $ref: '#/components/headers/X-RateLimit-Remaining'
            X-RateLimit-Reset:
              $ref: '#/components/headers/X-RateLimit-Reset'
            Idempotent-Replayed:
              $ref: '#/components/headers/Idempotent-Replayed'
        '202':
          description: The job is still going (or `wait` was false). Poll `poll_url`.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SkillRunResult'
          headers:
            X-Request-Id:
              $ref: '#/components/headers/X-Request-Id'
            X-RateLimit-Limit:
              $ref: '#/components/headers/X-RateLimit-Limit'
            X-RateLimit-Remaining:
              $ref: '#/components/headers/X-RateLimit-Remaining'
            X-RateLimit-Reset:
              $ref: '#/components/headers/X-RateLimit-Reset'
            Idempotent-Replayed:
              $ref: '#/components/headers/Idempotent-Replayed'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '409':
          $ref: '#/components/responses/Conflict'
        '413':
          $ref: '#/components/responses/TooLarge'
        '415':
          $ref: '#/components/responses/UnsupportedMedia'
        '422':
          $ref: '#/components/responses/Unprocessable'
        '429':
          $ref: '#/components/responses/RateLimited'
        '503':
          $ref: '#/components/responses/Unavailable'
components:
  parameters:
    XRequestId:
      name: X-Request-Id
      in: header
      required: false
      description: >-
        Your own id for this request — 8 to 128 letters, digits, `.`, `_`, `:`
        or `-`. Used in place of one we mint, and echoed back.
      schema:
        type: string
        pattern: ^[A-Za-z0-9][A-Za-z0-9._:-]{7,127}$
    IdempotencyKey:
      name: Idempotency-Key
      in: header
      required: false
      description: >-
        Retry this POST safely: the first request with a key runs and its answer
        is kept for a day; a retry with the same key and the same request gets
        that answer again, marked `Idempotent-Replayed: true`, instead of
        running twice. 1–255 printable characters — a UUID is a good one.
      schema:
        type: string
        minLength: 1
        maxLength: 255
  schemas:
    RunRemoveDuplicateRowsRequest:
      type: object
      title: Run Remove duplicate rows
      description: One of each row
      properties:
        url:
          type: string
          format: uri
          description: >-
            A public http(s) link to a document. Fetched once, checked like an
            upload.
        upload_id:
          type: string
          format: uuid
          description: >-
            A finished direct upload (POST /api/v1/uploads), for a file too big
            to send in the body.
        job_id:
          type: string
          format: uuid
          description: >-
            An earlier job's id, to run this over its source file without
            sending it again.
        asset_id:
          type: string
          format: uuid
          description: >-
            A Vault file's id. The file is copied for the run and left as it
            was.
        duration_seconds:
          type: number
          minimum: 0
          description: >-
            How long the source runs, when it can't be measured. Anything
            measured on our side wins over it.
        options:
          type: object
          title: Remove duplicate rows options
          properties:
            column:
              type: string
              title: Only compare
              default: ''
              maxLength: 100
              description: Up to 100 characters. Leave it empty to leave it out.
          additionalProperties: false
        wait:
          type: boolean
          default: true
          description: >-
            Hold the request until the job settles (up to 150 seconds). false
            answers 202 at once with a `poll_url`.
        webhook_url:
          type: string
          format: uri
          description: >-
            Where to POST the finished job, signed. Checked before anything is
            charged.
        dry_run:
          type: boolean
          default: false
          description: >-
            Check everything and answer with the price, step by step, instead of
            running. Nothing is charged, queued or stored.
        save_to_vault:
          description: >-
            true to file the results in the Vault, or {"folder": "Clients/Acme"}
            to say where.
          oneOf:
            - type: boolean
            - type: object
              properties:
                folder:
                  type: string
              additionalProperties: false
      allOf:
        - anyOf:
            - required:
                - url
            - required:
                - upload_id
            - required:
                - job_id
            - required:
                - asset_id
      additionalProperties: false
    SkillRunResult:
      allOf:
        - $ref: '#/components/schemas/Job'
        - type: object
          properties:
            credits_charged:
              type: integer
              description: Charged when the job started; refunded if it fails.
            vault:
              $ref: '#/components/schemas/VaultSave'
    DryRun:
      type: object
      description: >-
        What a run would cost, from `dry_run: true`: every check the run makes,
        then the price step by step instead of the run. Nothing is charged,
        queued or stored.
      properties:
        dry_run:
          const: true
        livemode:
          type: boolean
          description: False for a test key, whose runs would spend nothing.
        credits:
          type: integer
          description: What the run would charge in all.
        exact:
          type: boolean
          description: >-
            False when a step's price rests on a figure the run only learns as
            it goes — a length an earlier step hasn't made yet. Such a step has
            a `note`.
        breakdown:
          type: array
          items:
            type: object
            properties:
              step:
                type: integer
                minimum: 1
              tool:
                type: string
              credits:
                type: integer
              billed_on:
                type: string
                enum:
                  - file
                  - minute
                  - second
                  - page
                  - megapixels
                  - clip
                  - free
              runs:
                type: integer
                description: Once per file of a set above it.
              note:
                type: string
            required:
              - step
              - tool
              - credits
              - billed_on
        balance:
          type: object
          properties:
            monthly:
              type: integer
            topup:
              type: integer
            total:
              type: integer
            after:
              type: integer
        would_fail:
          type: object
          description: >-
            The refusal the live run would meet that the checks can't see — a
            short balance.
          properties:
            code:
              type: string
            message:
              type: string
      required:
        - dry_run
        - livemode
        - credits
        - exact
        - breakdown
        - balance
    Job:
      type: object
      description: >-
        One run of one skill, or one conversion. While `status` is `queued` or
        `processing`, poll `poll_url`.
      properties:
        id:
          type: string
          format: uuid
        status:
          type: string
          enum:
            - queued
            - processing
            - complete
            - failed
        skill:
          type:
            - string
            - 'null'
          description: The skill's slug; null for a conversion.
        format:
          type:
            - string
            - 'null'
          description: What a conversion wrote; null for a skill.
        source:
          type: object
          properties:
            name:
              type: string
            mime:
              type: string
            size_bytes:
              type: integer
        outputs:
          type: array
          items:
            $ref: '#/components/schemas/JobOutput'
        error:
          type:
            - string
            - 'null'
        created_at:
          type: string
          format: date-time
        updated_at:
          type: string
          format: date-time
        poll_url:
          type: string
          examples:
            - /api/v1/jobs/3f0c…
        livemode:
          type: boolean
          description: >-
            False for a test key's (`mm_test_…`) run, which charged nothing and
            ran nothing.
        test:
          const: true
          description: Present, and true, only on a test key's run.
      required:
        - id
        - status
        - outputs
        - poll_url
    VaultSave:
      type: object
      description: >-
        What `save_to_vault` filed. A run still going when the call came back
        says how to file it once it is done.
      properties:
        saved:
          type: array
          items:
            type: object
        pending:
          type: boolean
        next:
          type: string
        error:
          type: string
    Error:
      type: object
      description: >-
        Every refusal. `code` is stable and meant for programs; `message` is a
        sentence meant for people, and says what to do.
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              examples:
                - missing_file
                - bad_option
                - rate_limited
            message:
              type: string
            doc_url:
              type: string
              format: uri
              description: >-
                The heading on the errors page that explains this code and its
                fix.
              examples:
                - https://docs.mediamonster.app/api/errors#bad_option
            request_id:
              type: string
              description: The same id as the `X-Request-Id` header. Quote it to support.
              examples:
                - req_8fK2mQ0x7ZtLw3nVb1cR9dYe
            param:
              type: string
              description: The one field at fault, when there is one.
              examples:
                - edges
                - url
          required:
            - code
            - message
            - doc_url
            - request_id
      required:
        - error
    JobOutput:
      type: object
      description: >-
        One thing a job made. A file has a signed `url` that expires in ten
        minutes — read the job again rather than retry an old link. Words come
        back in `text`, and data (tags, boxes, facts) in `data`, with `url`
        null.
      properties:
        name:
          type: string
        kind:
          type: string
        mime:
          type: string
        size_bytes:
          type: integer
        width:
          type:
            - integer
            - 'null'
        height:
          type:
            - integer
            - 'null'
        url:
          type:
            - string
            - 'null'
          format: uri
        text:
          type:
            - string
            - 'null'
        data: {}
  headers:
    X-Request-Id:
      description: >-
        This request's id — yours, if you sent a well-formed `X-Request-Id`. The
        same as `error.request_id`. Quote it to support.
      schema:
        type: string
        examples:
          - req_8fK2mQ0x7ZtLw3nVb1cR9dYe
    X-RateLimit-Limit:
      description: Requests a minute this key may make. Absent on a plan with no limit.
      schema:
        type: integer
    X-RateLimit-Remaining:
      description: How many of them are left this minute.
      schema:
        type: integer
    X-RateLimit-Reset:
      description: When this minute's window ends, in unix seconds.
      schema:
        type: integer
    Idempotent-Replayed:
      description: >-
        `true` when this is the kept answer to an earlier request with the same
        `Idempotency-Key`, handed back instead of running again.
      schema:
        type: string
        enum:
          - 'true'
  responses:
    BadRequest:
      description: >-
        The request can't run as sent. Codes: missing_file, bad_option,
        unknown_option, bad_url, fetch_failed, bad_json, bad_file, wrong_input,
        missing_steps, bad_line, ambiguous_line, bad_recipe, bad_webhook,
        bad_upload_id, bad_idempotency_key, missing_input, bad_input,
        unknown_input, bad_inputs.
      headers:
        X-Request-Id:
          $ref: '#/components/headers/X-Request-Id'
        X-RateLimit-Limit:
          $ref: '#/components/headers/X-RateLimit-Limit'
        X-RateLimit-Remaining:
          $ref: '#/components/headers/X-RateLimit-Remaining'
        X-RateLimit-Reset:
          $ref: '#/components/headers/X-RateLimit-Reset'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error:
              code: missing_file
              message: What went wrong, and what to do instead.
              doc_url: https://docs.mediamonster.app/api/errors#missing_file
              request_id: req_8fK2mQ0x7ZtLw3nVb1cR9dYe
    Unauthorized:
      description: >-
        No key, or a key that isn't valid. Codes: missing_key, invalid_key,
        key_expired.
      headers:
        X-Request-Id:
          $ref: '#/components/headers/X-Request-Id'
        X-RateLimit-Limit:
          $ref: '#/components/headers/X-RateLimit-Limit'
        X-RateLimit-Remaining:
          $ref: '#/components/headers/X-RateLimit-Remaining'
        X-RateLimit-Reset:
          $ref: '#/components/headers/X-RateLimit-Reset'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error:
              code: missing_key
              message: What went wrong, and what to do instead.
              doc_url: https://docs.mediamonster.app/api/errors#missing_key
              request_id: req_8fK2mQ0x7ZtLw3nVb1cR9dYe
    PaymentRequired:
      description: 'Not enough credits for this run. Codes: insufficient_credits.'
      headers:
        X-Request-Id:
          $ref: '#/components/headers/X-Request-Id'
        X-RateLimit-Limit:
          $ref: '#/components/headers/X-RateLimit-Limit'
        X-RateLimit-Remaining:
          $ref: '#/components/headers/X-RateLimit-Remaining'
        X-RateLimit-Reset:
          $ref: '#/components/headers/X-RateLimit-Reset'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error:
              code: insufficient_credits
              message: What went wrong, and what to do instead.
              doc_url: https://docs.mediamonster.app/api/errors#insufficient_credits
              request_id: req_8fK2mQ0x7ZtLw3nVb1cR9dYe
    Forbidden:
      description: >-
        The key's scopes, addresses, mode, plan or role don't allow it. Codes:
        insufficient_scope, ip_not_allowed, test_mode_unsupported,
        plan_required, plan_limit, not_allowed.
      headers:
        X-Request-Id:
          $ref: '#/components/headers/X-Request-Id'
        X-RateLimit-Limit:
          $ref: '#/components/headers/X-RateLimit-Limit'
        X-RateLimit-Remaining:
          $ref: '#/components/headers/X-RateLimit-Remaining'
        X-RateLimit-Reset:
          $ref: '#/components/headers/X-RateLimit-Reset'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error:
              code: insufficient_scope
              message: What went wrong, and what to do instead.
              doc_url: https://docs.mediamonster.app/api/errors#insufficient_scope
              request_id: req_8fK2mQ0x7ZtLw3nVb1cR9dYe
    NotFound:
      description: >-
        Nothing with that id or slug that this key can see. Codes:
        unknown_skill, job_not_found, run_not_found, recipe_not_found,
        recipe_version_not_found, file_not_found, rule_not_found.
      headers:
        X-Request-Id:
          $ref: '#/components/headers/X-Request-Id'
        X-RateLimit-Limit:
          $ref: '#/components/headers/X-RateLimit-Limit'
        X-RateLimit-Remaining:
          $ref: '#/components/headers/X-RateLimit-Remaining'
        X-RateLimit-Reset:
          $ref: '#/components/headers/X-RateLimit-Reset'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error:
              code: unknown_skill
              message: What went wrong, and what to do instead.
              doc_url: https://docs.mediamonster.app/api/errors#unknown_skill
              request_id: req_8fK2mQ0x7ZtLw3nVb1cR9dYe
    Conflict:
      description: >-
        The thing named isn't in a state to do this. Codes: job_busy,
        upload_unfinished, upload_completing, job_not_finished,
        idempotency_in_progress.
      headers:
        X-Request-Id:
          $ref: '#/components/headers/X-Request-Id'
        X-RateLimit-Limit:
          $ref: '#/components/headers/X-RateLimit-Limit'
        X-RateLimit-Remaining:
          $ref: '#/components/headers/X-RateLimit-Remaining'
        X-RateLimit-Reset:
          $ref: '#/components/headers/X-RateLimit-Reset'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error:
              code: job_busy
              message: What went wrong, and what to do instead.
              doc_url: https://docs.mediamonster.app/api/errors#job_busy
              request_id: req_8fK2mQ0x7ZtLw3nVb1cR9dYe
    TooLarge:
      description: >-
        The file is over the plan's ceiling, or the request body over 100 MB.
        Codes: file_too_large.
      headers:
        X-Request-Id:
          $ref: '#/components/headers/X-Request-Id'
        X-RateLimit-Limit:
          $ref: '#/components/headers/X-RateLimit-Limit'
        X-RateLimit-Remaining:
          $ref: '#/components/headers/X-RateLimit-Remaining'
        X-RateLimit-Reset:
          $ref: '#/components/headers/X-RateLimit-Reset'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error:
              code: file_too_large
              message: What went wrong, and what to do instead.
              doc_url: https://docs.mediamonster.app/api/errors#file_too_large
              request_id: req_8fK2mQ0x7ZtLw3nVb1cR9dYe
    UnsupportedMedia:
      description: 'The file isn''t one we take. Codes: unsupported_media.'
      headers:
        X-Request-Id:
          $ref: '#/components/headers/X-Request-Id'
        X-RateLimit-Limit:
          $ref: '#/components/headers/X-RateLimit-Limit'
        X-RateLimit-Remaining:
          $ref: '#/components/headers/X-RateLimit-Remaining'
        X-RateLimit-Reset:
          $ref: '#/components/headers/X-RateLimit-Reset'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error:
              code: unsupported_media
              message: What went wrong, and what to do instead.
              doc_url: https://docs.mediamonster.app/api/errors#unsupported_media
              request_id: req_8fK2mQ0x7ZtLw3nVb1cR9dYe
    Unprocessable:
      description: >-
        Understood, but can't be done with this file. Codes: step_unavailable,
        nothing_to_save, idempotency_key_reused.
      headers:
        X-Request-Id:
          $ref: '#/components/headers/X-Request-Id'
        X-RateLimit-Limit:
          $ref: '#/components/headers/X-RateLimit-Limit'
        X-RateLimit-Remaining:
          $ref: '#/components/headers/X-RateLimit-Remaining'
        X-RateLimit-Reset:
          $ref: '#/components/headers/X-RateLimit-Reset'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error:
              code: step_unavailable
              message: What went wrong, and what to do instead.
              doc_url: https://docs.mediamonster.app/api/errors#step_unavailable
              request_id: req_8fK2mQ0x7ZtLw3nVb1cR9dYe
    RateLimited:
      description: >-
        Over the key's, or the account's, requests a minute. Codes:
        rate_limited, free_tool_limit.
      headers:
        X-Request-Id:
          $ref: '#/components/headers/X-Request-Id'
        X-RateLimit-Limit:
          $ref: '#/components/headers/X-RateLimit-Limit'
        X-RateLimit-Remaining:
          $ref: '#/components/headers/X-RateLimit-Remaining'
        X-RateLimit-Reset:
          $ref: '#/components/headers/X-RateLimit-Reset'
        retry-after:
          description: Seconds to wait.
          schema:
            type: integer
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error:
              code: rate_limited
              message: What went wrong, and what to do instead.
              doc_url: https://docs.mediamonster.app/api/errors#rate_limited
              request_id: req_8fK2mQ0x7ZtLw3nVb1cR9dYe
    Unavailable:
      description: >-
        Switched off here, or briefly unreachable. Codes: api_unavailable,
        rate_limit_unavailable, webhooks_off, idempotency_unavailable.
      headers:
        X-Request-Id:
          $ref: '#/components/headers/X-Request-Id'
        X-RateLimit-Limit:
          $ref: '#/components/headers/X-RateLimit-Limit'
        X-RateLimit-Remaining:
          $ref: '#/components/headers/X-RateLimit-Remaining'
        X-RateLimit-Reset:
          $ref: '#/components/headers/X-RateLimit-Reset'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error:
              code: api_unavailable
              message: What went wrong, and what to do instead.
              doc_url: https://docs.mediamonster.app/api/errors#api_unavailable
              request_id: req_8fK2mQ0x7ZtLw3nVb1cR9dYe
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
      bearerFormat: mm_live_… or mm_test_…
      description: >-
        `Authorization: Bearer mm_live_…`. Mint a key at mediamonster.app/keys;
        every plan includes the API. A test key, `mm_test_…`, runs every check a
        live key does and spends nothing: each run finishes at once with a
        stand-in file, and says `livemode: false`. A key does only what its
        scopes allow.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.