The request is `multipart/form-data`: - one JSON part named `body` (`FactoryIntakeForm`) whose `fields` object holds   intake data (material, finish, quantity, notes, …). Material and finish   are required customer-visible catalog names; all other fields are stored   verbatim so they can be added or renamed without an API change. - one or more file parts (any part name). At least one file is required.

The submitter's identity (email, name, user id) comes from the authenticated account, not the form.

Fetch `GET /user/factory/materials` and `GET /user/factory/finishes`, then send the returned exact `material` and `finish` names. The server rejects missing, non-string, unknown, deleted, and internal-only choices with these stable field-specific `error_code` values: - `factory_material_input_missing` - `factory_material_input_invalid_type` - `factory_material_not_found` - `factory_material_not_customer_visible` - `factory_finish_input_missing` - `factory_finish_input_invalid_type` - `factory_finish_not_found` - `factory_finish_not_customer_visible` - `quantity`: a positive integer.

Example `body` part: ```json { "fields": { "material": "6061 Aluminum", "finish": "Anodized", "quantity": 10, "notes": "deburr all edges" } } ```

Example request (curl): ``` curl -X POST https://api.zoo.dev/user/factory/jobs \   -H "Authorization: Bearer $ZOO_API_TOKEN" \   -F 'body={"fields":{"material":"6061 Aluminum","finish":"Anodized","quantity":10}};type=application/json' \   -F 'file=@bracket.step' ```

Returns `201` with the created job (`FactoryJobResponse`).

Response returned when a Factory job is created. Only customer-facing ids are exposed: the job id (the customer's reference) and its current version id. The internal Help Desk thread id is deliberately NOT returned (internal-only per the ERD).

The current (first) version id of the job.

Access-Control-Allow-Headers header. This is a comma-separated list of headers.

The Content-Location header for responses that are not the final destination. This is used to indicate where the resource can be found, when it is finished.

The location header for redirects and letting users know if there is a websocket they can listen to for status updates on their operation.

ID for this request. We return it so that users can report this to us and help us debug their problems.

Submit a part for manufacturing. Requires a signed-in Zoo account.

Zookeeper

Zookeeper: The Conversational CAD Agent For Parametric Modeling

Automation

Automating Your Workflow

File Formats

A Practical Overview of CAD File Formats

KCL: A Programming Language for Parametric CAD

Geometry Engine

Zoo CAD Engine Overview

Overview

Getting Started

Parametric Modeling

Assemblies

Geometric Analysis

3D Design

Modes

Queue and Steer

Zoodle

Revertible AI Changes

ML / AI

Simulation

GD&T Annotations (MBD)

Documentation

Import

Export

Version Control

Default Project Folder

Aquarium

Data Management

Technical Support

Zoo Design Studio Stream

System Requirements

Project Browser

Modeling Area

New Window

Feature Tree

Bodies Pane

Code Editor

File Explorer

Variables Pane

Command Bar

AI Chat

Top Bar

Status Bar

Settings

Appearance

Workspace

Features

Aquarium CAD Gallery

Zoo Design Studio

Engine API

Agent API

File Format API

Authentication

Errors

Generate a CAD model from text.

List conversations

Converts a proprietary CAD format to KCL.

Create a custom ML model that is backed by one or more org datasets.

Retrieve the details of a single custom ML model so long as it belongs to the caller’s organization.

Update mutable metadata (name, system prompt) for a custom ML model owned by the caller's organization.

List the org datasets that are currently attached to a custom ML model owned by the caller’s organization.

Generate code completions for KCL.

Iterate on a CAD model with a prompt.

Iterate on a multi-file CAD model with a prompt.

List text-to-CAD parts you've generated.

Get a text-to-CAD response.

Give feedback to a specific ML response.

Open a websocket to prompt the ML copilot.

Open a websocket which accepts modeling commands.

Modeling

Get details of an API call.

Get an async operation.

List API calls for your org.

Get an API call for an org.

List API calls for your user.

Get an API call for a user.

List API calls for a user.

API Calls

List API tokens for your user.

Create a new API token for your user.

Get an API token for your user.

Delete an API token for your user.

API Tokens

Listen for callbacks to GitHub app authentication.

Get the consent URL for GitHub app authentication.

Listen for GitHub webhooks.

Apps

Execute a Zoo program in a specific language.

Create a terminal.

Executor

List finishes currently available for customer Factory submissions.

List materials currently available for customer Factory submissions.

Factory

Get CAD file center of mass.

Convert CAD file from one format to another.

Convert CAD file with defaults.

Get CAD file density.

Get CAD file mass.

Get CAD file surface area.

Get CAD file volume.

File

Get OpenAPI schema.

Get ip address information.

List all active announcements.

Authorize an inbound auth request from our Community page.

Get an API token for a user by their discord ID.

Return pong.

Get the pricing for our subscriptions.

Get a pending OAuth 2.0 authorization request for the consent page.

Approve a pending OAuth 2.0 authorization request.

Deny a pending OAuth 2.0 authorization request.

Start an OAuth 2.0 authorization code flow with PKCE.

Start an OAuth 2.0 Device Authorization Grant.

Confirm an OAuth 2.0 Device Authorization Grant.

Request a device access token.

Verify an OAuth 2.0 Device Authorization Grant.

Listen for callbacks for the OAuth 2.0 provider.

Get the consent URL and other information for the OAuth 2.0 provider.

Exchange an authorization code or refresh token for an OAuth 2.0 access token.

Revoke an OAuth2 token.

Verify OAuth account linking and complete the authentication.

List org OAuth apps.

Create an org OAuth app.

Get an org OAuth app.

Update an org OAuth app.

Delete an org OAuth app.

List OAuth 2.0 apps owned by an organization.

List personal OAuth apps.

Create a personal OAuth app.

Get a personal OAuth app.

Update a personal OAuth app.

Delete a personal OAuth app.

List OAuth 2.0 apps owned by a user.

Oauth2

Get an org.

Update an org.

Create an org.

Delete an org.

Get the authenticated organization's aggregate-usage collection threshold.

Set the authenticated organization's aggregate-usage collection threshold.

Restore the default for the authenticated organization's aggregate-usage collection threshold.

Return the IAM policies customers should apply when onboarding an S3 dataset.

List every dataset that belongs to the caller's organization.

Register a new org dataset.

Fetch a single dataset by ID so long as it belongs to the authenticated org.

Update dataset metadata or storage credentials for the caller's organization.

Delete a dataset owned by the caller's organization.

Bulk-download KCL outputs for successful dataset conversions.

List the file conversions that have been processed for a given dataset owned by the caller's org.

Fetch the metadata and converted output for a single dataset conversion.

Download the original source file for a specific dataset conversion.

Retrigger a specific dataset conversion for the caller's org.

Request a retrigger of conversions for a dataset that belongs to the caller's org.

Search dataset conversions by conversion ID or file path.

Run semantic search across chunked conversion outputs for a dataset.

Return aggregate conversion stats for a dataset owned by the caller's org.

Upload source files into a Zoo-managed dataset.

List members of your org.

Add a member to your org.

Get a member of your org.

Update a member of your org.

Remove a member from your org.

Get the privacy settings for an org.

Update the privacy settings for an org.

Get the SAML identity provider.

Update the SAML identity provider.

Create a SAML identity provider.

Delete an SAML identity provider.

Get the shortlinks for an org.

List every skill that belongs to the caller's organization.

Get the billing contract for an organization.

Create or replace the billing contract for an organization.

Get a user's org.

Orgs

Get payment info about your org.

Update payment info for your org.

Create payment info for your org.

Delete payment info for your org.

Get balance for your org.

Create a payment intent for your org.

List invoices for your org.

Redirect to a fresh Stripe-hosted payment-method update link for your org.

List payment methods for your org.

Delete a payment method for your org.

Get the subscription for an org.

Update the subscription for an org.

Create the subscription for an org.

Validate an orgs's information is correct and valID for automatic tax.

Get balance for an org.

Update balance for an org.

Update the subscription for any org (admin override).

Payments

API Reference

Developer Tools

Submit a part for manufacturing. Requires a signed-in Zoo account
hidden

HTTP Request

HTTP BodyBinary

Content-Type:multipart/form-data

Response

201 Created

current_version_id:

id:

status:

}

Examples

Submit a part for manufacturing. Requires a signed-in Zoo accounthidden