canonical: https://jentic.com/apis/deformity.ai/deformity

# Deformity External API

The Deformity API creates and publishes AI-generated and static forms within an organization's workspaces. Agents draft a form from a prompt or a list of questions, revise its questions, and publish it live, with a quickstart operation for classic forms built from plain question strings. A form can be soft-deleted, which also removes any custom domain mapping attached to it.

## For AI agents

Create AI or static form drafts, update their questions, and publish them live through Deformity. List forms and workspaces, and soft-delete forms within an organization.

## Scope

Does not handle response storage, payment collection, or email delivery. Use for building and publishing forms only.

## Capabilities

- Create an AI or static form draft from a prompt or a question list
- Spin up a classic form from a name and question strings via quickstart
- Update a form draft's questions before publishing
- Publish a form draft to make it live
- List active forms and the organization's workspaces
- Soft-delete a form and remove its custom domain mapping

## Use cases

### Agent-Built Forms

An AI agent turns a plain-language request into a live form: it creates an AI form draft from the prompt, reviews the generated questions, and publishes it. The agent discovers the create and publish operations through Jentic by intent, so it builds and ships the form without hardcoding endpoint paths.

Example prompt: Create an AI form draft from a prompt, review its questions, then publish the form and return its live link

### Publish a Survey Fast

A team needs a quick survey without opening a builder UI. The agent calls the quickstart operation with a form name and a list of question strings, then publishes the resulting draft. Deformity generates the classic form structure from the strings, so the agent only supplies the questions.

Example prompt: Call quickstart with a form name and a list of questions, then publish the draft

### Form Lifecycle Management

An operations agent keeps an organization's forms tidy. It lists the active forms across workspaces, updates the questions on a draft that needs changes, and soft-deletes forms that are no longer used. Because delete is a soft-delete that also unmaps the custom domain, the agent can retire a form cleanly.

Example prompt: List the forms in a workspace, update the questions on one draft, and soft-delete a retired form

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| GET | `/forms` | List active forms |
| POST | `/forms` | Create an AI or static form draft |
| GET | `/forms/{formId}` | Get a form draft and its questions |
| PATCH | `/forms/{formId}` | Update a form draft |
| POST | `/forms/quickstart` | Create a classic form from questions |
| POST | `/forms/{formId}/publish` | Publish a form draft |
| GET | `/workspaces` | List organization workspaces |
| DELETE | `/forms/{formId}` | Soft-delete a form |

## Key resources

- **Forms** — Create, read, update, publish, and soft-delete AI and static forms
- **Workspaces** — List the organization's workspaces
- **Quickstart** — Create a classic form draft from a name and question strings

## AI readiness

This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use.

- **Score:** 67 / 100
- **Maturity:** AI-Aware
- **Dimensions:**
  - Foundational Compliance: 100 / 100
  - Developer Experience & Jentic Compatibility: 69 / 100
  - AI-Readiness & Agent Experience: 45 / 100
  - Agent Usability: 94 / 100
  - Security: 60 / 100
  - AI Discoverability: 81 / 100
- **View full report:** https://jentic.com/apis/deformity.ai/deformity/scorecard
- **How the score is calculated:** https://docs.jentic.com/reference/api-readiness-framework/overview/
- **More about the dimensions:** https://docs.jentic.com/reference/api-readiness-framework/specification/#dimensional-model-overview

### Score it yourself

Every API in the directory is allowlisted, so you can re-score it with no key required.

- **Score your own API:** https://jentic.com/scorecard.md
- **Scoring CLI agent skill:** https://github.com/jentic/jentic-api-scorecard/blob/main/skills/jentic-api-scorecard/SKILL.md

```sh
npx @jentic/api-scorecard-cli score <openapi-url>
```

## Why Jentic

- **Setup:** Wiring Deformity by hand means creating an organization-scoped API key and sending it as a bearer token on every form call. Through Jentic you install once, import Deformity from the API Directory, store the key once, and your agent calls it.
- **Permission scoping:** You choose which Deformity operations your agent may call, so you can allow form creation and updates while leaving publish and soft-delete out unless you add them. Deformity carries the form id in the URL path, so rules bound which operations run.
- **Credential handling:** Your Deformity key is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as create an AI form or publish a form, and Jentic returns the matching Deformity operation with its input schema so the agent calls the right endpoint without reading the reference docs.

## Related APIs

- **Typeform** — Typeform builds conversational forms and surveys; Deformity generates AI and static forms from a prompt or question list.
- **Jotform** — Jotform offers a large template library and integrations; Deformity focuses on quickly drafting and publishing forms through an API.
- **Formstack** — Formstack adds workflow and document automation around forms; Deformity covers the form creation and publishing step.

## FAQ

### What authentication does the Deformity API use?

The Deformity API authenticates with an organization-scoped API key sent as a bearer token in the Authorization header, per its OpenAPI spec. Through Jentic the key is stored encrypted by your own Jentic One instance and injected at call time, so it never lands in the agent's prompt or logs.

### Can I build AI forms with the Deformity API?

Yes. The create-form operation drafts an AI or static form from your input, and the quickstart operation builds a classic form from a name and question strings. Publish the draft when you are ready to make it live.

### What are the rate limits for the Deformity API?

The OpenAPI spec does not publish rate limits for the Deformity API. Check Deformity's own API documentation, linked from its external docs, for the current limits on your organization's key.

### Can I limit what my agent is allowed to do with the Deformity API?

Yes. Write a rule that allows only form creation and updates, so the agent can draft and revise forms while publish and soft-delete stay out unless you add them. Every call the agent makes is logged.

### How do I publish a form with the Deformity API through Jentic?

Search Jentic for an intent like create and publish a form, store your organization key once, and your agent calls the create operation and then the publish operation for the returned form. To run it on your own infrastructure, install Jentic One from its GitHub repo.

### Is there a Deformity MCP server?

You don't need an MCP server to give your agent the Deformity API. Jentic connects it directly from the API Directory: import it, store your key once, and your agent calls the operations it needs on demand.