# flows

> WhatsApp Flows library: install, map, publish, preview.

WhatsApp Flows library: install, map, publish, preview.

| Method | Path | Operation | Scope | Test mode |
|---|---|---|---|---|
| GET | `/v1/flow-components` | `flow_components_list`: Flow components | `templates:read` | - |
| GET | `/v1/flow-library` | `flow_library_list`: Flow library | `templates:read` | - |
| GET | `/v1/flows` | `flows_list`: Installed flows | `templates:read` | - |
| POST | `/v1/flows` | `flows_install`: Install a flow from the library | `templates:write` | - |
| DELETE | `/v1/flows/{flow_id}` | `flows_delete`: Delete a draft flow | `templates:write` | - |
| GET | `/v1/flows/{flow_id}` | `flows_get`: Get a flow | `templates:read` | - |
| PATCH | `/v1/flows/{flow_id}` | `flows_update`: Rename a form | `templates:write` | - |
| GET | `/v1/flows/{flow_id}/definition` | `flows_definition_get`: A form's screens and questions | `templates:read` | - |
| PUT | `/v1/flows/{flow_id}/definition` | `flows_definition_put`: Save a form's screens and questions | `templates:write` | - |
| POST | `/v1/flows/{flow_id}/deprecate` | `flows_deprecate`: Deprecate a published flow | `templates:write` | - |
| DELETE | `/v1/flows/{flow_id}/draft` | `flows_draft_discard`: Throw away the unpublished edit of a published form | `templates:write` | - |
| PUT | `/v1/flows/{flow_id}/mapping` | `flows_mapping_put`: Map response fields | `templates:write` | - |
| POST | `/v1/flows/{flow_id}/preview` | `flows_preview`: Send the flow to a phone for testing | `templates:read` | - |
| POST | `/v1/flows/{flow_id}/publish` | `flows_publish`: Publish a flow at Meta | `templates:write` | - |
| GET | `/v1/flows/{flow_id}/responses` | `flows_responses_list`: Submitted responses | `conversations:read` | - |
| GET | `/v1/flows/{flow_id}/versions` | `flows_versions_list`: A form's versions | `templates:read` | - |
| POST | `/v1/flows/custom` | `flows_create`: Create a form from scratch | `templates:write` | - |
| POST | `/v1/flows/validate` | `flows_definition_validate`: Check a form definition without saving it | `templates:read` | - |

Request and response schemas: the interactive reference at `https://api.wapitick.com/docs`, or `docs/api/openapi.json`.
