SnozeDevelopers
API referencePublic forms

Read the public manifest for a published form

Returns everything an anonymous page needs to render the form — title, copy, theme, steps, and the visible fields with their options and validation — and nothing about internal ids. No authentication; the workspace slug and form slug in the path are the only credential, and a slug pair that does not resolve to a public, enabled form is reported as not found.

GET
/v1/public/forms/{workspaceSlug}/{slug}

Path Parameters

workspaceSlug*string
slug*string

Response Body

Success

application/json
  1. response
data*
Example Request
curl -X GET 'https://api.snoze.dev/v1/public/forms/string/string'
Example Response
{  "data": {    "slug": "string",    "title": "string",    "description": "string",    "submitLabel": "string",    "successMessage": "string",    "fields": [      {        "key": "string",        "label": "string",        "icon": "string",        "kind": "text",        "required": true,        "helpText": "string",        "placeholder": "string",        "options": [          {            "key": "string",            "name": "string",            "color": "string"          }        ],        "rating": {          "max": 0,          "icon": "star"        },        "numberFormat": {          "kind": "number",          "decimals": 0        },        "display": {          "variant": "string",          "prefix": "string",          "suffix": "string",          "min": 0,          "max": 0,          "step": 0,          "minLabel": "string",          "maxLabel": "string",          "count": 0,          "icon": "string"        },        "validation": {          "tooltip": "string",          "errorMessage": "string",          "min": 0,          "max": 0,          "minLength": 0,          "maxLength": 0,          "pattern": "string"        },        "step": 0,        "multiple": true      }    ],    "steps": [      {        "id": "string",        "title": "string",        "description": "string"      }    ],    "theme": {      "layout": "traditional",      "frame": "card",      "cardColor": "string",      "background": {        "type": "none",        "color": "string",        "gradient": "string",        "gradientFrom": "string",        "gradientTo": "string",        "gradientAngle": 0,        "imageUrl": "string",        "blur": 0      },      "accent": "string",      "radius": 0,      "colorScheme": "auto",      "textColor": "string",      "mutedTextColor": "string",      "buttonTextColor": "string",      "inputColor": "string"    }  }}

Check a model's agent compatibility

Makes one bounded, billable synthetic tool-calling request using the platform key. Does not test media understanding. Platform admins only.

Submit a response to a published form

Creates one record in the form's backing database from `values`, writing only the fields the form exposes publicly; keys that are not accepted visible fields are rejected. Send a `submissionId` to make retries safe: a repeat with the same id and values replays the first result. No authentication; the workspace slug and form slug in the path are the only credential. Submissions are rate limited per caller per minute and again per caller and form, so bursts are refused with a rate-limit error carrying a retry delay.