Samva
DashboardAPI
ChannelsPlatformMailboxesDevelopersEmail templatesIntegrationsAPI Reference
TopicForms

Delete a topic form (Preview)

Preview · Available to selected organizations. Deletes a form belonging to the visible topic. Its public key immediately stops accepting signups.

DELETE
/v1/topics/{id}/forms/{formId}

Deletes a form belonging to the visible topic. Its public key immediately stops accepting signups. Existing email confirmation links keep their snapshotted copy and remain valid until expiry. Requires topicSignup.

Authorization

apiKey
x-api-key<token>

In: header

Path Parameters

id*string
Match^unsub_[0-9a-hjkmnp-tv-z]{16,24}$
formId*string
Match^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|[fF]{8}-[fF]{4}-[fF]{4}-[fF]{4}-[fF]{12})$
Formatuuid

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X DELETE "https://example.com/v1/topics/string/forms/497f6eca-6276-4993-bfeb-53cbbbba6f08"
{  "success": true}

Related documentation

List topic forms (Preview)

Preview · Available to selected organizations. Lists the signup forms belonging to the visible topic.

Update a topic form (Preview)

Preview · Available to selected organizations. Updates only the supplied form fields. allowedOrigins replaces the complete exact-origin allowlist; redirectUrl null clears the success redirect.