# Formasty Forms API

**Canonical:** https://apis.io/apis/formasty-com/formasty-com-forms-api/  
**Provider:** Formasty — https://apis.io/providers/formasty-com/  
**Base URL:** https://app.formasty.com/api/v1  
**Documentation:** https://formasty.com/documentation/overview

Formasty Forms API is one of 3 APIs that [Formasty](https://apis.io/providers/formasty-com/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 4 JSON Schema definitions. Tagged areas include Forms. The published artifact set on APIs.io includes an OpenAPI specification and 4 JSON Schemas.

The Forms API from Formasty — 20 operation(s) for forms.

## Operations (27)

| Method | Path | Summary |
|---|---|---|
| GET | `/forms` | List accessible forms |
| POST | `/forms` | Create a form draft |
| GET | `/forms/{form_id}` | Get one form |
| PATCH | `/forms/{form_id}` | Update form title or draft |
| DELETE | `/forms/{form_id}` | Delete a form |
| PUT | `/forms/{form_id}/draft` | Save the complete form draft |
| POST | `/forms/{form_id}/steps` | Create a draft step |
| POST | `/forms/{form_id}/steps/reorder` | Reorder draft steps |
| PATCH | `/forms/{form_id}/steps/{step_id}` | Update a draft step |
| DELETE | `/forms/{form_id}/steps/{step_id}` | Delete a draft step |
| POST | `/forms/{form_id}/steps/{step_id}/fields` | Create a draft field |
| PATCH | `/forms/{form_id}/fields/{field_id}` | Update a draft field |
| DELETE | `/forms/{form_id}/fields/{field_id}` | Delete a draft field |
| POST | `/forms/{form_id}/steps/{step_id}/fields/reorder` | Reorder fields in a draft step |
| PUT | `/forms/{form_id}/steps/{step_id}/logic` | Replace draft step logic |
| PATCH | `/forms/{form_id}/design` | Update draft design |
| POST | `/forms/{form_id}/validate` | Validate a form draft |
| POST | `/forms/{form_id}/publish` | Publish a form |
| POST | `/forms/{form_id}/workflow/rules` | Create or replace one workflow rule |
| PATCH | `/forms/{form_id}/quiz` | Configure quiz result rules |
| POST | `/forms/{form_id}/thank-you-screens` | Create an additional ending screen |
| PATCH | `/forms/{form_id}/thank-you-screens/{screen_id}` | Update an additional ending screen |
| DELETE | `/forms/{form_id}/thank-you-screens/{screen_id}` | Delete an additional ending screen |
| POST | `/forms/{form_id}/media-assets/generated` | Ingest an AI-generated image asset |
| GET | `/forms/{form_id}/submissions` | List form submissions |
| POST | `/forms/{form_id}/submissions` | Create a submission |
| GET | `/forms/{form_id}/submissions/{submission_id}` | Get one submission |

## Machine-readable artifacts (5)

- **OpenAPI** — https://artifacts.apis.io/formasty-com/openapi/formasty-com-forms-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/formasty-com/json-schema/formasty-com-draft-schema-schema.json
- **JSONSchema** — https://artifacts.apis.io/formasty-com/json-schema/formasty-com-draft-mutation-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/formasty-com/json-schema/formasty-com-form-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/formasty-com/json-schema/formasty-com-quiz-config-schema.json

## Other Formasty APIs (2)

- [Formasty Capabilities API](https://apis.io/apis/formasty-com/formasty-com-capabilities-api/)
- [Formasty Me API](https://apis.io/apis/formasty-com/formasty-com-me-api/)

## Tags

Forms

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/formasty-com/formasty-com-forms-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/formasty-com/.