This endpoint requires authentication by a Zoo employee. The API calls are grouped by the parameter passed.

group_by

The email of the user that requested the API call.

The user ID of the user that requested the API call.

The origin of the API call. This is parsed from the `Origin` header.

The IP address of the user making the API call.

Array_of_ApiCallQueryGroup

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.

Get API call metrics.

This endpoint requires authentication by a Zoo employee. The API calls are returned in order of creation, with the most recently created API calls 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 API calls.

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

If the user is not authenticated to view the specified API call, then it is not returned.

Only Zoo employees can view API calls for other users.

An API call with the price.

This is a join of the `ApiCall` and `ApiCallPrice` tables.

Get details of an API call.

For async file conversion operations, this endpoint does not return the contents of converted files (`output`). To get the contents use the `/async/operations/{id}` endpoint.

This endpoint requires authentication by a Zoo employee.

status

The async API call was uploaded to be converted.

List async operations.

Get the status and output of an async operation.

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

If the user is not authenticated to view the specified async operation, then it is not returned.

Only Zoo employees with the proper access can view async operations for other users.

Get an async operation.

This includes all API calls that were made by users in the org.

This endpoint requires authentication by an org admin. It returns the API calls for the authenticated user's org.

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

List API calls for your org.

This endpoint requires authentication by an org admin. It returns details of the requested API call for the user's org.

Get an API call for an org.

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

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

List API calls for your user.

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

Get an API call for a user.

This endpoint requires authentication by any Zoo user. It returns the API calls for the authenticated user if "me" is passed as the user id.

Alternatively, you can use the `/user/api-calls` endpoint to get the API calls for your user.

If the authenticated user is a Zoo employee, then the API calls are returned for the user specified by the user id.

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

List API calls for a user.

API calls that have been performed by users can be queried by the API. This is helpful for debugging as well as billing.

api-calls

API Calls

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

The response from the `AddHoleFromOffset` command.

If the offset path splits into multiple paths, this will contain the UUIDs of the new paths. If the offset path remains as a single path, this will be empty, and the resulting ID of the (single) new path will be the ID of the `AddHoleFromOffset` command.

The email address of the user to add to the org.

An ISO-3166 alpha-2 country code. Always uppercase.

The country component. This is a two-letter ISO country code.

Edge info struct (useful for maintaining mappings between edges and faces and adjacent/opposite edges).

The size of the angle, measured in the chosen unit.

How to style the end of the annotation line.

How to style the start of the annotation line.

How to style the start and end of the line

2D annotation type (screen or planar space)

A response for a query on the API call table that is grouped by something.

The date and time the API call completed billing.

DateTime

The date and time the API call was created.

int64

String

The Request Method (VERB)

This type also contains constants for a number of common HTTP methods such as GET, POST, etc.

Currently includes 8 variants representing the 8 methods defined in [RFC 7230](https://tools.ietf.org/html/rfc7231#section-4.1), plus PATCH, and an Extension variant for all extensions.

The HTTP method requested by the API call.

The number of minutes the API call was billed for.

The organization ID of the API call if it is billable through an organization.

double

The request query params sent by the API call.

The response body returned by the API call. We do not store this information if it is above a certain size.

The date and time the API call started billing.

The status code returned by the API call.

int32

The Stripe invoice item ID of the API call if it is billable.

The date and time the API call was last updated.

The ID of the user that made the API call.

token used to fetch the next page of results (if any)

The type of error sent by the KittyCAD API.

An API token.

These are used to authenticate users with Bearer authentication.

The date and time the API token was created.

If the token is valid. We never delete API tokens, but we can mark them as invalid. We save them for ever to preserve the history of the API token.

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

The date and time the API token was last updated.

The ID of the user that owns the API token.

Information about a third party app client.

The number of times we've attempted to process this job.

The time and date the async API call was completed.

The time and date the async API call was created.

The unique identifier of the async API call.

This is the same as the API call ID.

The JSON input for the API call. These are determined by the endpoint that is run.

The JSON output for the API call. These are determined by the endpoint that is run.

The time and date the async API call was started.

The time and date the async API call was last updated.

The user ID of the user who created the async API call.

The worker node that is performing or performed the async API call.

The time and date the API call was completed.

The time and date the API call was created.

The unique identifier of the API call.

This is the same as the API call ID.

The output format of the file conversion.

The output format options of the file conversion.

The converted files (if multiple file conversion), if completed, base64 encoded. The key of the map is the path of the output file.

The source format of the file conversion.

The source format options of the file conversion.

The time and date the API call was started.

The time and date the API call was last updated.

The user ID of the user who created the API call.

The material density as denoted by the user.

The material mass as denoted by the user.

The code for the model. This is optional but will be required in the future once we are at v1.

The output of the model in the given file format the user requested, base64 encoded. The key of the map is the path of the output file.

The original source code for the model, previous to the changes.

The prompt for the overall changes. This is optional if you only want changes on specific source ranges.

The source ranges the user suggested to change.

The version of kcl to use. If empty, the latest version will be used.

The output files. Returns a map of the file name to the file contents. The file contents are not encoded since kcl files are not binary.

The project name. This is used to tie the prompt to a project. Which helps us make our models better over time.

The prompt for the overall changes. This is optional if you only want changes on specific source ranges. This will apply to all the files.

The authentication callback from the OAuth 2.0 client. This is typically posted to the redirect URL as query params after authenticating.

For Apple only, a JSON web token containing the user’s identity information.

The state that we had passed in through the user consent URL.

For Apple only, a JSON string containing the data requested in the scope property. The returned data is in the following format: `{ "name": { "firstName": string, "lastName": string }, "email": string }`

Co-ordinate axis specifier.

See [cglearn.eu] for background reading.

[cglearn.eu]: https://cglearn.eu/pub/computer-graphics/introduction-to-geometry#material-coordinate-systems-1

Specifies the sign of a co-ordinate axis.

Specifies which direction the axis is pointing.

Response sent when a request did not succeed.

Errors that occurred during the modeling command.

Websocket responses can either be successful or unsuccessful. Slightly different schemas in either case.

The user is missing a payment method and has exceeded their free API call credits for the month.

The response from the 'BooleanIntersection'.

If the operation produced just one solid, then its ID will be the ID of the modeling command request. But if any extra solids are produced, then their IDs will be included here.

The response from the `CameraDragEnd` command.

Camera rotate (spherical camera revolve/orbit)

Camera rotate (trackball with 3 degrees of freedom)

Camera zoom (increase or decrease distance to reference point center)

The response from the `CameraDragMove` command. Note this is an "unreliable" channel message, so this data may need more data like a "sequence"

The response from the `CameraDragStart` endpoint.

A type of camera movement applied after certain camera operations

Adjusts the camera position during the camera operation

Camera settings including position, center, fov etc

Camera's look-at center (center-pos gives viewing vector)

Camera's field-of-view angle (if ortho is false)

The Camera's orientation (in the form of a quaternion)

Whether or not the camera is in ortho mode

The camera's ortho scale (derived from viewing distance if ortho is true)

Card brand.

Can be `amex`, `diners`, `discover`, `jcb`, `mastercard`, `unionpay`, `visa`, or `unknown`.

Checks on Card address and CVC if provided.

Two-letter ISO code representing the country of the card.

Two-digit number representing the card's expiration month.

Four-digit number representing the card's expiration year.

Uniquely identifies this particular card number.

Card funding type.

Can be `credit`, `debit`, `prepaid`, or `unknown`.

ClientMetrics contains information regarding the state of the peer.

The height of the inbound video stream in pixels.

https://www.w3.org/TR/webrtc-stats/#dom-rtcinboundrtpstreamstats-frameheight

The width of the inbound video stream in pixels.

https://www.w3.org/TR/webrtc-stats/#dom-rtcinboundrtpstreamstats-framewidth

Counter of the number of WebRTC frames that the client has decoded from the inbound video stream.

https://www.w3.org/TR/webrtc-stats/#dom-rtcinboundrtpstreamstats-freezecount

Counter of the number of WebRTC frames the client has dropped from the inbound video stream.

https://www.w3.org/TR/webrtc-stats/#dom-rtcinboundrtpstreamstats-framesdropped

Current number of frames being rendered in the last second. A good target is 60 frames per second, but it can fluctuate depending on network conditions.

https://www.w3.org/TR/webrtc-stats/#dom-rtcinboundrtpstreamstats-freezecount

Counter of the number of WebRTC frames that the client has received from the inbound video stream.

https://www.w3.org/TR/webrtc-stats/#dom-rtcinboundrtpstreamstats-freezecount

Number of times the inbound video playback has frozen. This is usually due to network conditions.

https://www.w3.org/TR/webrtc-stats/#dom-rtcinboundrtpstreamstats-freezecount

Amount of "jitter" in the inbound video stream. Network latency is the time it takes a packet to traverse the network. The amount that the latency varies is the jitter. Video latency is the time it takes to render a frame sent by the server (including network latency). A low jitter means the video latency can be reduced without impacting smooth playback. High jitter means clients will increase video latency to ensure smooth playback.

https://www.w3.org/TR/webrtc-stats/#dom-rtcreceivedrtpstreamstats-jitter

Number of "key frames" decoded in the inbound h.264 stream. A key frame is an expensive (bandwidth-wise) "full image" of the video frame. Data after the keyframe become -- effectively -- "diff" operations on that key frame. The Engine will only send a keyframe if required, which is an indication that some of the "diffs" have been lost, usually an indication of poor network conditions. We like this metric to understand times when the connection has had to recover.

https://www.w3.org/TR/webrtc-stats/#dom-rtcinboundrtpstreamstats-keyframesdecoded

Amount of packets lost in the inbound video stream.

https://www.w3.org/TR/webrtc-stats/#dom-rtcreceivedrtpstreamstats-packetslost

Count of the total number of video pauses experienced by this receiver.

https://www.w3.org/TR/webrtc-stats/#dom-rtcinboundrtpstreamstats-pausecount

Count the total number of Picture Loss Indication (PLI) packets.

https://www.w3.org/TR/webrtc-stats/#dom-rtcinboundrtpstreamstats-plicount

Total duration of pauses in seconds.

This is the "ping" between the client and the STUN server. Not to be confused with the E2E RTT documented [here](https://www.w3.org/TR/webrtc-stats/#dom-rtcremoteinboundrtpstreamstats-roundtriptime)

https://www.w3.org/TR/webrtc-stats/#dom-rtcicecandidatepairstats-currentroundtriptime

Number of seconds of frozen video the user has been subjected to.

https://www.w3.org/TR/webrtc-stats/#dom-rtcinboundrtpstreamstats-totalfreezesduration

Count of the total number of video pauses experienced by this receiver.

https://www.w3.org/TR/webrtc-stats/#dom-rtcinboundrtpstreamstats-totalpausesduration

The response from the `ClosePath` command.

The UUID of the lone face of the resulting solid2D.

The language code is written in.

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

```json { "description": "The language code is written in.", "oneOf": [ { "description": "The `go` programming language.", "type": "string", "enum": [ "go" ] }, { "description": "The `python` programming language.", "type": "string", "enum": [ "python" ] }, { "description": "The `node` programming language.", "type": "string", "enum": [ "node" ] } ] } ``` </details>

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>

Output of the code being executed.

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

```json { "description": "Output of the code being executed.", "type": "object", "properties": { "output_files": { "description": "The contents of the files requested if they were passed.", "type": "array", "items": { "$ref": "#/components/schemas/OutputFile" } }, "stderr": { "description": "The stderr of the code.", "default": "", "type": "string" }, "stdout": { "description": "The stdout of the code.", "default": "", "type": "string" } } } ``` </details>

The contents of the files requested if they were passed.

Output file contents.

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

```json { "description": "Output file contents.", "type": "object", "properties": { "contents": { "description": "The contents of the file. This is base64 encoded so we can ensure it is UTF-8 for JSON.", "type": "string" }, "name": { "description": "The name of the file.", "default": "", "type": "string" } } } ``` </details>

Struct to contain the edge information of a wall of an extrude/rotate/loft/sweep.

Every edge that shared one common vertex with the original edge.

The opposite edge has no common vertices with the original edge. A wall may not have an opposite edge (i.e. a revolve that touches the axis of rotation).

Container that holds a translate, rotate and scale. Defaults to no change, everything stays the same (i.e. the identity function).

Rotate component of the transform. The rotation is specified as an axis and an angle (xyz are the components of the axis, w is the angle in degrees).

Rotate component of the transform. The rotation is specified as a roll, pitch, yaw.

Describes the file to convert (src) and what it should be converted into (output).

Amount (in the `currency` specified) that will be taken off the subtotal of any invoices for this customer.

Name of the coupon displayed to customers on, for instance invoices, or receipts.

By default the `id` is shown if `name` is not set.

Percent that will be taken off the subtotal of any invoices for this customer for the duration of the coupon.

For example, a coupon with percent_off of 50 will make a %s100 invoice %s50 instead.

The password for the shortlink, if you want to restrict access to it. This can only be set if your subscription allows for it. Otherwise, it will return an error. When you access the link it will be required to enter this password through basic auth. The username will be `{anything}` and the password will be the password you set here.

If the shortlink should be restricted to the user's organization to view. This only applies to org shortlinks. If you are creating a user shortlink and you are not a member of a team or enterprise and you try to set this to true, it will fail.

The key for this url. This is what you use to update or delete the specific shortlink.

The data for subscribing a user to the newsletter.

Currency is the list of supported currencies. Always lowercase.

This comes from the Stripe API docs: For more details see <https://support.stripe.com/questions/which-currencies-does-stripe-support>.

The response from the `CurveGetControlPoints` command.

The response from the `CurveGetType` command.

The response from the `CurveSetConstraint` endpoint.

The resource representing a payment "Customer".

Current balance, if any, being stored on the customer in the payments service.

If negative, the customer has credit to apply to their next invoice. If positive, the customer has an amount owed that will be added to their next invoice. The balance does not refer to any unpaid invoices; it solely takes into account amounts that have yet to be successfully applied to any invoice. This balance is only taken into account as invoices are finalized.

Three-letter ISO code for the currency the customer can be charged in for recurring billing purposes.

When the customer's latest invoice is billed by charging automatically, `delinquent` is `true` if the invoice's latest charge failed.

When the customer's latest invoice is billed by sending an invoice, `delinquent` is `true` if the invoice isn't paid by its due date.  If an invoice is marked uncollectible by dunning, `delinquent` doesn't get reset to `false`.

APIAPI Calls

Endpoints