# dotsy Forms API

**Canonical:** https://apis.io/apis/dotsy-ai/dotsy-ai-forms-api/  
**Provider:** dotsy — https://apis.io/providers/dotsy-ai/  
**Base URL:** https://api.dotsy.ai  
**Documentation:** https://api.dotsy.ai/docs

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

Read the submissions a site's forms have collected.

## Operations (16)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/v1/sites/{slug}/suggestions` | List form suggestions for moderation |
| POST | `/api/v1/sites/{slug}/suggestions/approve` | Approve a suggestion as a draft board item |
| POST | `/api/v1/sites/{slug}/suggestions/merge` | Merge a suggestion into an existing item |
| POST | `/api/v1/sites/{slug}/suggestions/decline` | Decline a suggestion |
| POST | `/api/v1/sites/{slug}/ideas` | Add an idea from outside the site |
| GET | `/api/v1/sites/{slug}/ideas` | Search items and open suggestions by title overlap |
| GET | `/api/v1/sites/{slug}/form-submissions/export.csv` | Export a form's submissions as CSV |
| GET | `/api/v1/sites/{slug}/form-submissions` | List form submissions, newest first |
| GET | `/api/v1/sites/{slug}/form-submissions/{id}` | Get one form submission with every field |
| GET | `/api/v1/sites/{slug}/forms/recipients` | List form email recipients |
| POST | `/api/v1/sites/{slug}/forms/recipients/confirm-requests` | Email an address a link to confirm form emails |
| DELETE | `/api/v1/sites/{slug}/forms/recipients/{email}` | Stop form emails to a confirmed address |
| GET | `/api/v1/forms/confirm/{token}` | Preview a form email confirm link |
| POST | `/api/v1/forms/confirm/{token}` | Confirm form emails |
| GET | `/api/v1/forms/unsubscribe/{token}` | Preview a stop-form-emails link |
| POST | `/api/v1/forms/unsubscribe/{token}` | Stop form emails |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/dotsy-ai/openapi/dotsy-ai-forms-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/dotsy-ai/json-schema/dotsy-ai-site-schema.json
- **JSONSchema** — https://artifacts.apis.io/dotsy-ai/json-schema/dotsy-ai-route-schema.json
- **JSONSchema** — https://artifacts.apis.io/dotsy-ai/json-schema/dotsy-ai-draft-status-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/dotsy-ai/json-schema/dotsy-ai-route-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/dotsy-ai/json-schema/dotsy-ai-search-performance-schema.json
- **JSONSchema** — https://artifacts.apis.io/dotsy-ai/json-schema/dotsy-ai-import-site-request-schema.json

## Other dotsy APIs (12)

- [dotsy Account API](https://apis.io/apis/dotsy-ai/dotsy-ai-account-api/)
- [dotsy Assets API](https://apis.io/apis/dotsy-ai/dotsy-ai-assets-api/)
- [dotsy Brief API](https://apis.io/apis/dotsy-ai/dotsy-ai-brief-api/)
- [dotsy Collections API](https://apis.io/apis/dotsy-ai/dotsy-ai-collections-api/)
- [dotsy Content API](https://apis.io/apis/dotsy-ai/dotsy-ai-content-api/)
- [dotsy Domains API](https://apis.io/apis/dotsy-ai/dotsy-ai-domains-api/)
- [dotsy Draft & publish API](https://apis.io/apis/dotsy-ai/dotsy-ai-draft-publish-api/)
- [dotsy Guest API](https://apis.io/apis/dotsy-ai/dotsy-ai-guest-api/)
- [dotsy Import API](https://apis.io/apis/dotsy-ai/dotsy-ai-import-api/)
- [dotsy Jobs API](https://apis.io/apis/dotsy-ai/dotsy-ai-jobs-api/)
- [dotsy Members API](https://apis.io/apis/dotsy-ai/dotsy-ai-members-api/)
- [dotsy Pages API](https://apis.io/apis/dotsy-ai/dotsy-ai-pages-api/)

## Tags

Forms

---

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