AnyCutlist Parse Jobs API

The Parse Jobs API from AnyCutlist — 2 operation(s) for parse jobs.

Operations 5

GET /parse-jobs List parse jobs #
POST /parse-jobs Queue a parse job #
GET /parse-jobs/{id} Get a parse job; parts and summary once it has finished #
PATCH /parse-jobs/{id} Retry a failed parse job #
DELETE /parse-jobs/{id} Cancel or delete a parse job #

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/anycutlist-com:anycutlist-com-parse-jobs-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

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. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

anycutlist-com-parse-jobs-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: AnyCutlist Parse Jobs API
  version: 1.0.0
  description: 'Programmatic access to AnyCutlist, cutlist software for cut-and-edge shops: read customers'' cutting lists, manage cut lists and boards, optimize and export.


    **Authentication.** Send an organization API key as `Authorization: Bearer cai_...`. Organization admins create keys in Settings, API & Connections. API access is included on the Professional and Enterprise plans.


    **Scopes.** Each key carries scopes; each operation lists the scopes it accepts (`x-required-scopes`, any one of them). Endpoints not listed here refuse API keys.


    **Limits and errors.** Each key has a per-minute limit; responses carry X-RateLimit-* headers, and a 429 carries Retry-After. Errors are JSON with `error`, usually a stable `code`, and a `requestId`.


    **AI agents.** A remote MCP server at https://www.anycutlist.com/api/mcp offers task-shaped tools over the same keys, with idempotency keys on every create call and revision checks on calls about a saved cut list. Two scopes exist only for it: `request:quotes` and `request:exports` let an assistant ask for a quote or a machine file, which a person approves in AnyCutlist; no REST endpoint accepts them, and no API key can approve a request. See https://www.anycutlist.com/developers.'
  contact:
    name: AnyCutlist
    url: https://www.anycutlist.com/contact
  termsOfService: https://www.anycutlist.com/terms
servers:
- url: https://www.anycutlist.com/api/v1
security:
- apiKey: []
tags:
- name: Parse Jobs
paths:
  /parse-jobs:
    get:
      summary: List parse jobs
      parameters:
      - name: page
        in: query
        schema:
          type: integer
          minimum: 1
          default: 1
      - name: limit
        in: query
        schema:
          type: integer
          minimum: 1
          maximum: 100
          default: 20
      - name: status
        in: query
        schema:
          type: string
      x-required-scopes:
      - parse:text
      - parse:file
      - parse:image
      responses:
        2XX:
          description: Success (JSON)
        4XX:
          $ref: '#/components/responses/Error'
      tags:
      - Parse Jobs
      operationId: getParseJobs
      x-operation-id-source: derived
    post:
      summary: Queue a parse job
      description: A file source needs parse:file; text, table and voice sources need parse:text. Returns 201 with job.id.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - source
              properties:
                source:
                  oneOf:
                  - type: object
                    required:
                    - type
                    - content
                    properties:
                      type:
                        const: text
                      content:
                        type: string
                        minLength: 1
                        maxLength: 500000
                      format:
                        enum:
                        - free_text
                        - csv_inline
                        - json_inline
                        default: free_text
                  - type: object
                    required:
                    - type
                    - fileId
                    properties:
                      type:
                        const: file
                      fileId:
                        type: string
                        format: uuid
                      mimeType:
                        type: string
                  - type: object
                    required:
                    - type
                    - headers
                    - rows
                    description: Rows are joined as CSV and read as text; set options.aiMode for the AI reader.
                    properties:
                      type:
                        const: table
                      headers:
                        type: array
                        items:
                          type: string
                        minItems: 1
                        maxItems: 200
                      rows:
                        type: array
                        items:
                          type: array
                          items:
                            type: string
                        minItems: 1
                        maxItems: 10000
                  - type: object
                    required:
                    - type
                    - transcript
                    properties:
                      type:
                        const: voice
                      transcript:
                        type: string
                      audioUrl:
                        type: string
                        format: uri
                options:
                  type: object
                  properties:
                    aiMode:
                      type: boolean
                      default: false
                      description: Read with the AI reader (uses an AI parse credit).
                    defaultMaterialId:
                      type: string
                    defaultThicknessMm:
                      type: number
                cutlistId:
                  type: string
                  format: uuid
      x-required-scopes:
      - parse:text
      - parse:file
      - parse:image
      responses:
        2XX:
          description: Success (JSON)
        4XX:
          $ref: '#/components/responses/Error'
      tags:
      - Parse Jobs
      operationId: postParseJobs
      x-operation-id-source: derived
  /parse-jobs/{id}:
    get:
      summary: Get a parse job; parts and summary once it has finished
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      x-required-scopes:
      - parse:text
      - parse:file
      - parse:image
      responses:
        2XX:
          description: Success (JSON)
        4XX:
          $ref: '#/components/responses/Error'
      tags:
      - Parse Jobs
      operationId: getParseJobsById
      x-operation-id-source: derived
    patch:
      summary: Retry a failed parse job
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      x-required-scopes:
      - parse:text
      - parse:file
      - parse:image
      responses:
        2XX:
          description: Success (JSON)
        4XX:
          $ref: '#/components/responses/Error'
      tags:
      - Parse Jobs
      operationId: patchParseJobsById
      x-operation-id-source: derived
    delete:
      summary: Cancel or delete a parse job
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      x-required-scopes:
      - parse:text
      - parse:file
      - parse:image
      responses:
        2XX:
          description: Success (JSON)
        4XX:
          $ref: '#/components/responses/Error'
      tags:
      - Parse Jobs
      operationId: deleteParseJobsById
      x-operation-id-source: derived
components:
  responses:
    Error:
      description: Refused
      content:
        application/json:
          schema:
            type: object
            properties:
              error:
                type: string
              code:
                type: string
              requestId:
                type: string
  securitySchemes:
    apiKey:
      type: http
      scheme: bearer
      description: 'Organization API key: cai_ followed by 32 hex characters.'
externalDocs:
  description: Developers and AI agents
  url: https://www.anycutlist.com/developers