Because our source of truth for the resulting model is a STEP file, you will always have STEP file contents when you list your generated models. Any other formats you request here will also be returned when you list your generated models.

This operation is performed asynchronously, the `id` of the operation will be returned. You can use the `id` returned from the request to get status information about the async operation from the `/async/operations/{id}` endpoint.

One thing to note, if you hit the cache, this endpoint will return right away. So you only have to wait if the status is not `Completed` or `Failed`.

The format the output file should be converted to.

output_format

Autodesk Filmbox (FBX) format. <https://en.wikipedia.org/wiki/FBX>

Binary glTF 2.0.

This is a single binary with .glb extension.

This is better if you want a compressed format as opposed to the human readable glTF that lacks compression.

glTF 2.0. Embedded glTF 2.0 (pretty printed).

Single JSON file with .gltf extension binary data encoded as base64 data URIs.

The JSON contents are pretty printed.

It is human readable, single file, and you can view the diff easily in a git commit.

The OBJ file format. <https://en.wikipedia.org/wiki/Wavefront_.obj_file> It may or may not have an an attached material (mtl // mtllib) within the file, but we interact with it as if it does not.

The PLY file format. <https://en.wikipedia.org/wiki/PLY_(file_format)>

The STEP file format. <https://en.wikipedia.org/wiki/ISO_10303-21>

The STL file format. <https://en.wikipedia.org/wiki/STL_(file_format)>

If we should output the kcl for the model.

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

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

Generate a CAD model from text.

For text-to-cad prompts, this will always return the STEP file contents as well as the format the user originally requested.

This endpoint requires authentication by a Zoo employee.

The ML prompts are returned in order of creation, with the most recently created ML prompts first.

Maximum number of items returned by a single call

limit

Token returned by previous call to retrieve the subsequent page

page_token

sort_by

Supported set of sort modes for scanning by created_at only.

Currently, we only support scanning in ascending order.

Sort in increasing order of "created_at".

Sort in decreasing order of "created_at".

List all ML prompts.

This endpoint requires authentication by a Zoo employee.

Get a ML prompt.

This endpoint requires authentication by any Zoo user. It returns the conversations for the authenticated user.

The conversations are returned in order of creation, with the most recently created conversations first.

List conversations

This endpoint is used to convert a proprietary CAD format to KCL. The file passed MUST have feature tree data.

A STEP file does not have feature tree data, so it will not work. A sldprt file does have feature tree data, so it will work.

Input filepaths will be normalized and re-canonicalized to be under the current working directory -- so returned paths may differ from provided paths, and care must be taken when handling user provided paths.

The options to run on the code. By default this is set to `execute`.

code_option

Code option for running and verifying kcl.

<details><summary>JSON schema</summary>

```json { "title": "CodeOption", "description": "Code option for running and verifying kcl.", "type": "string", "enum": [ "parse", "execute", "cleanup", "mock_execute" ] } ``` </details>

Converts a proprietary CAD format to KCL.

A request to generate KCL code completions.

Generate code completions for KCL.

Even if you give specific ranges to edit, the model might change more than just those in order to make the changes you requested without breaking the code.

You always get the whole code back, even if you only changed a small part of it.

This operation is performed asynchronously, the `id` of the operation will be returned. You can use the `id` returned from the request to get status information about the async operation from the `/async/operations/{id}` endpoint.

This endpoint will soon be deprecated in favor of the `/ml/text-to-cad/multi-file/iteration` endpoint. In that the endpoint path will remain but it will have the same behavior as `ml/text-to-cad/multi-file/iteration`.

Iterate on a CAD model with a prompt.

This endpoint can iterate on multi-file models.

Even if you give specific ranges to edit, the model might change more than just those in order to make the changes you requested without breaking the code.

You always get the whole code back, even if you only changed a small part of it. This endpoint will always return all the code back, including files that were not changed. If your original source code imported a stl/gltf/step/etc file, the output will not include that file since the model will never change non-kcl files. The endpoint will only return the kcl files that were changed.

This operation is performed asynchronously, the `id` of the operation will be returned. You can use the `id` returned from the request to get status information about the async operation from the `/async/operations/{id}` endpoint.

Input filepaths will be normalized and re-canonicalized to be under the current working directory -- so returned paths may differ from provided paths, and care must be taken when handling user provided paths.

Body for iterating on models from text prompts.

A response from a text to CAD multi-file iteration.

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

This will always return the STEP file contents as well as the format the user originally requested.

This endpoint requires authentication by any Zoo user. It returns the text-to-CAD models for the authenticated user.

The text-to-CAD models are returned in order of creation, with the most recently created text-to-CAD models first.

If specified, only return the prompts for the conversation id given.

conversation_id

If we should return the model file contents or just the metadata.

no_models

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

This endpoint requires authentication by any Zoo user. The user must be the owner of the text-to-CAD model.

Type that encompasses all Text-to-CAD response types, including iteration and multi-file iteration.

Get a text-to-CAD response.

This can be a text-to-CAD creation or iteration.

This endpoint requires authentication by any Zoo user. The user must be the owner of the ML response, in order to give feedback.

feedback

Give feedback to a specific ML response.

The types of messages that can be sent by the client to the server.

The types of messages that can be sent by the server to the client.

Open a websocket to prompt the ML copilot.

Machine learning to generate CAD models and other things.

Geometry Engine

Zoo CAD Engine Overview

KCL: A Programming Language for Parametric CAD

File Formats

A Practical Overview of CAD File Formats

Text-to-CAD

Text-to-CAD: Generating Editable, Parametric B-Rep CAD Models from Natural Language

Automation

Automating Your Workflow

Features

Getting Started

Zoo Design Studio

Authentication

Errors

Open a websocket which accepts modeling commands.

Modeling

Get API call metrics.

List API calls.

Get details of an API call.

List async operations.

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

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.

APIML

Endpoints