---
title: "Prepare an editable gripper draft"
method: POST
path: "/workbenches/gripper/prepare"
---

# Prepare an editable gripper draft

`POST /workbenches/gripper/prepare`

## Request

- Base URL: `https://aiurion.com/api/agent/v1`
- URL: `https://aiurion.com/api/agent/v1/workbenches/gripper/prepare`
- Auth: HTTP bearer

Compliant gripper kits with two TPU pads, two rigid carriers and two keepers per kit. No quote allowance is consumed. Returns canonical configuration, warnings, revision and editable browser review link. REST body limit 12 MB; MCP limit 8 MB including encoding.

## Request body

- object
  - `configuration` object: Partial jaw configuration. Omitted fields use the Gripper Lab defaults. Lengths are millimetres.
    - `preview_gap` number: Opening
    - `pad_width` number: Pad width
    - `pad_height` number: Pad height
    - `gyroid_depth` number: Gyroid layer
    - `lattice_depth` number: Rib layer
    - `grip_depth` number: Contact depth
    - `gyroid_period` number: Cell size
    - `gyroid_level` number: Sheet level
    - `gyroid_resolution` number: Export spacing
    - `wave_count` integer: Contact waves
    - `face_skin` number: Contact wall
    - `spine_depth` number: Retention spine
    - `rib_count` integer: Rib count
    - `rib_thickness` number: Rib wall
    - `rib_bow` number: Rib bow limit
    - `root_fillet` number: Root allowance
    - `fit_clearance` number: Sliding fit
    - `backer_thickness` number: Carrier thickness
    - `rail_neck` number: Rail neck
    - `rail_head` number: Rail head
    - `rail_depth` number: Rail depth limit
    - `bottom_stop` number: Lower seat
    - `vertical_clearance` number: Vertical fit
    - `keeper_thickness` number: Keeper thickness
    - `retaining_bolt_diameter` number: Retaining bolt bore
    - `mount_access_clearance` number: Driver clearance
    - `mount_spacing` number: Mounting centers
    - `mount_hole_diameter` number: Mounting bore
    - `mount_slot_extra` number: Slot adjustment
    - `mount_head_diameter` number: Mounting head
    - `mounting_slots` boolean
    - `quantity` integer: Complete kits; each kit has two pads, two carriers and two keepers.
    - `padMaterialId` 'black_tpu_85a' | 'black_tpu_95a'
    - `rigidMaterialId` 'black_pla' | 'red_pla' | 'silver_pla' | 'matte_black_pla' | 'orange_petg' | 'white_petg' | 'black_petg' | 'black_asa' | 'black_ppa_cf'
    - `productionSpeed` 'standard' | 'rush'
    - `fulfillmentMethod` 'shipping' | 'pickup' | 'courier'

## Response `200`

Reviewable draft

- object
  - `success` true, required
  - `workbench` 'gripper', required
  - `configuration` object, required
    - `preview_gap` number, required: Opening
    - `pad_width` number, required: Pad width
    - `pad_height` number, required: Pad height
    - `gyroid_depth` number, required: Gyroid layer
    - `lattice_depth` number, required: Rib layer
    - `grip_depth` number, required: Contact depth
    - `gyroid_period` number, required: Cell size
    - `gyroid_level` number, required: Sheet level
    - `gyroid_resolution` number, required: Export spacing
    - `wave_count` integer, required: Contact waves
    - `face_skin` number, required: Contact wall
    - `spine_depth` number, required: Retention spine
    - `rib_count` integer, required: Rib count
    - `rib_thickness` number, required: Rib wall
    - `rib_bow` number, required: Rib bow limit
    - `root_fillet` number, required: Root allowance
    - `fit_clearance` number, required: Sliding fit
    - `backer_thickness` number, required: Carrier thickness
    - `rail_neck` number, required: Rail neck
    - `rail_head` number, required: Rail head
    - `rail_depth` number, required: Rail depth limit
    - `bottom_stop` number, required: Lower seat
    - `vertical_clearance` number, required: Vertical fit
    - `keeper_thickness` number, required: Keeper thickness
    - `retaining_bolt_diameter` number, required: Retaining bolt bore
    - `mount_access_clearance` number, required: Driver clearance
    - `mount_spacing` number, required: Mounting centers
    - `mount_hole_diameter` number, required: Mounting bore
    - `mount_slot_extra` number, required: Slot adjustment
    - `mount_head_diameter` number, required: Mounting head
    - `mounting_slots` boolean, required
    - `quantity` integer, required: Complete kits; each kit has two pads, two carriers and two keepers.
    - `padMaterialId` 'black_tpu_85a' | 'black_tpu_95a', required
    - `rigidMaterialId` 'black_pla' | 'red_pla' | 'silver_pla' | 'matte_black_pla' | 'orange_petg' | 'white_petg' | 'black_petg' | 'black_asa' | 'black_ppa_cf', required
    - `productionSpeed` 'standard' | 'rush', required
    - `fulfillmentMethod` 'shipping' | 'pickup' | 'courier', required
  - `revision` string, required
  - `reviewUrl` string, uri, required: Editable review link containing private design information in its fragment.
  - `build` object
  - `warnings` string[]
  - `checkout` object
    - `mode` 'browser'
    - `url` string, uri
    - `approvalRequired` unknown

## Other responses

- `400`: Invalid request
- `401`: Missing, invalid, inactive, or expired token
- `403`: The credential lacks the required scope
- `404`: Resource not found
- `409`: Request conflict
- `413`: Uploaded request is too large
- `415`: Unsupported request content type
- `429`: Rate or beta quota exceeded
- `500`: Unexpected server error
- `503`: Agent API temporarily unavailable

---

[API](https://skmtc.dev/aiurion/apis/aiurion-agentic-3d-printing-api.md) · [All operations](https://skmtc.dev/aiurion/apis/aiurion-agentic-3d-printing-api/llms.txt) · [OpenAPI document](https://skmtc.dev/aiurion/apis/aiurion-agentic-3d-printing-api/revisions/949ce997a10c?raw)