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

The API tokens are returned in order of creation, with the most recently created API tokens 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".

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.

List API tokens for your user.

This endpoint requires authentication by any Zoo user. It creates a new API token for the authenticated user.

label

An API token with the full, unobfuscated token value.

This is used specifically for the creation endpoint response, where the user needs to see the full token exactly once. All other endpoints return the obfuscated version via the `ApiToken` struct.

Create a new API token for your user.

This endpoint requires authentication by any Zoo user. It returns details of the requested API token for the user.

token

An auth token. A uuid with a prefix of api-

An API token.

These are used to authenticate users with Bearer authentication.

Get an API token for your user.

This endpoint requires authentication by any Zoo user. It deletes the requested API token for the user.

This endpoint does not actually delete the API token from the database. It merely marks the token as invalid. We still want to keep the token in the database for historical purposes.

The token path parameter can be either the full API token (prefixed with `api-`) or the token's unique ID (a UUID).

The API token (prefixed with `api-`) or the token's unique ID (a UUID).

Delete an API token for your user.

API tokens allow users to call the API outside of their session token that is used as a cookie in the user interface. Users can create, delete, and list their API tokens. But, of course, you need an API token to do this, so first be sure to generate one in the account UI.

api-tokens

API Tokens

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

3D Design

Modes

Queue and Steer

Zoodle

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

Body 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

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.

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.

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.

API Tokens

Endpoints