Skip to content

Form

A Form is a set of fields someone fills in on a Site or in a Message, producing a Lead, Evidence, or a Thing.

Properties

PropertyTypeRequiredDescription
fieldsjsonrequiredThe fields and their types.

Object

JSON
{
  "$id": "https://api.sb/quietcopy.com/forms/form_1",
  "$type": "Form",
  "fields": {}
}

Relationships

  • A Form captures many Leads: each Form submission creates a Lead. captures, inverse capturedBy.
  • A Form is embedded in many Pages: Forms sit on Pages; one Form appears on many Pages. embeddedIn, inverse embeds.

Verbs

  1. createCreates a Form.
    POST /{namespace}/formsdoForm.created
  2. getReturns one Form by id.
    GET /{namespace}/forms/{id}readNo Event
  3. listReturns Forms, newest first, one page at a time.
    GET /{namespace}/formsreadNo Event
  4. updateChanges the given properties of a Form.
    PATCH /{namespace}/forms/{id}doForm.updated
  5. deleteDeletes a Form; its history is kept.
    DELETE /{namespace}/forms/{id}doForm.deleted

Permissions

Which Access level may call each Verb. One-way Verbs wait their delay window.

Operationowneradminmemberviewer
Form.createYesYesYesNo
Form.getYesYesYesYes
Form.listYesYesYesYes
Form.updateYesYesYesNo
Form.deleteYesYesYesNo

Call it

Text
Add a form to TutorLoop.

Example

The booking Form on a home-inspector directory asks for the address, the closing date, and a phone number. Each submission creates a Lead and offers it to three inspectors.