Dashform

Get a published Form Revision

Reads the live Form Revision of a published Form without a credential: the Form as it was published, including the questions it asks. Address the Form by its public id under the wildcard Organization, as its public URL does. Only the live Revision is served; any other Revision is refused as a bad request, and a Form that was never published answers not found.

GET
/organizations/{organizationRef}/forms/{formRef}/revisions/{formRevisionRef}

Path Parameters

organizationRef*||

The Organization that owns the Form: the wildcard -, its canonical id, or its slug. Responses always carry the canonical id.

formRef*||

The Form, addressed by its public id, the segment its public URL carries, or by its canonical id. The wildcard - is not accepted. Responses always carry the canonical id.

formRevisionRef*unknown

The Revision to read: live, the published Revision. No other Revision is served without a credential.

Response Body

OK

application/json
  1. response

A published Form Revision.

alternateIds?array<>

Output only. Server-specified ids that also address this Revision: latest when it is the most recently created, live when it is the published one.

Default[]
createTime*string

RFC 3339 timestamp when the Form Revision was published.

Formatdate-time
number*integer

Output only. Computed chronological position within the Form, starting at 1; 0 before persistence.

Range0 <= value <= 9007199254740991
path*string

Canonical Form Revision resource path in the form organizations/{organization_id}/forms/{form_id}/revisions/{form_revision_id}.

Match^organizations\/([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|ffffffff-ffff-ffff-ffff-ffffffffffff)\/forms\/([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|ffffffff-ffff-ffff-ffff-ffffffffffff)\/revisions\/([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|ffffffff-ffff-ffff-ffff-ffffffffffff)$
snapshot*

The Form as it was when published.

Example Request
curl -X GET 'https://getaiform.com/api/v1/organizations/497f6eca-6276-4993-bfeb-53cbbbba6f08/forms/497f6eca-6276-4993-bfeb-53cbbbba6f08/revisions/live'
Example Response
{  "alternateIds": [],  "createTime": "2019-08-24T14:15:22Z",  "number": 0,  "path": "string",  "snapshot": {    "aiHandoff": {      "enabled": true    },    "backgrounds": [      {        "overlayOpacity": 0,        "position": "left-half",        "type": "image",        "url": "string"      }    ],    "branding": {      "enabled": true,      "logoLinkUrl": "string",      "logoUrl": "string"    },    "context": [      "string"    ],    "createTime": "2019-08-24T14:15:22Z",    "defaultMode": "guided",    "description": "string",    "i18n": {      "sourceLocale": "string",      "supportedLocales": [        "string"      ],      "translations": {        "property1": {          "description": {            "override": true,            "sourceHash": "string",            "stale": true,            "value": "string"          },          "name": {            "override": true,            "sourceHash": "string",            "stale": true,            "value": "string"          },          "steps": {            "property1": {              "buttonText": {                "override": true,                "sourceHash": "string",                "stale": true,                "value": "string"              },              "description": {                "override": true,                "sourceHash": "string",                "stale": true,                "value": "string"              },              "options": [                {                  "override": true,                  "sourceHash": "string",                  "stale": true,                  "value": "string"                }              ],              "title": {                "override": true,                "sourceHash": "string",                "stale": true,                "value": "string"              }            },            "property2": {              "buttonText": {                "override": true,                "sourceHash": "string",                "stale": true,                "value": "string"              },              "description": {                "override": true,                "sourceHash": "string",                "stale": true,                "value": "string"              },              "options": [                {                  "override": true,                  "sourceHash": "string",                  "stale": true,                  "value": "string"                }              ],              "title": {                "override": true,                "sourceHash": "string",                "stale": true,                "value": "string"              }            }          }        },        "property2": {          "description": {            "override": true,            "sourceHash": "string",            "stale": true,            "value": "string"          },          "name": {            "override": true,            "sourceHash": "string",            "stale": true,            "value": "string"          },          "steps": {            "property1": {              "buttonText": {                "override": true,                "sourceHash": "string",                "stale": true,                "value": "string"              },              "description": {                "override": true,                "sourceHash": "string",                "stale": true,                "value": "string"              },              "options": [                {                  "override": true,                  "sourceHash": "string",                  "stale": true,                  "value": "string"                }              ],              "title": {                "override": true,                "sourceHash": "string",                "stale": true,                "value": "string"              }            },            "property2": {              "buttonText": {                "override": true,                "sourceHash": "string",                "stale": true,                "value": "string"              },              "description": {                "override": true,                "sourceHash": "string",                "stale": true,                "value": "string"              },              "options": [                {                  "override": true,                  "sourceHash": "string",                  "stale": true,                  "value": "string"                }              ],              "title": {                "override": true,                "sourceHash": "string",                "stale": true,                "value": "string"              }            }          }        }      }    },    "leadScoring": {      "enabled": true,      "high": "string",      "low": "string",      "medium": "string"    },    "live": false,    "marketplace": {      "bookingUrl": "string",      "category": "string",      "description": "string",      "industry": "string",      "languages": [        "string"      ],      "location": {        "address": "string",        "area": "string",        "city": "string"      },      "name": "string",      "services": [        {          "category": "string",          "description": "string",          "duration": "string",          "name": "string",          "priceRange": {            "currency": "string",            "max": 0,            "min": 0          }        }      ],      "enabled": true    },    "maxFollowUpQuestions": 0,    "name": "string",    "path": "string",    "publicId": "string",    "publicUrl": "string",    "replyCount": 0,    "steps": [      {        "background": {          "overlayOpacity": 0,          "position": "left-half",          "type": "image",          "url": "string"        },        "branches": [          {            "groups": [              [                {                  "negate": true,                  "operator": "equals",                  "stepKey": "string",                  "value": "string"                }              ]            ],            "targetStepKey": "string"          }        ],        "description": "string",        "key": "string",        "title": "string",        "buttonText": "string",        "logoUrl": "string",        "redirectUrl": "string",        "type": "start"      }    ],    "theme": {      "backgroundColor": "string",      "buttonRadiusPx": 0,      "buttonSize": "regular",      "buttonTextColor": "string",      "fontFamily": "sans",      "foregroundColor": "string",      "primaryColor": "string",      "textAnimation": "typing",      "textSize": "regular"    },    "tone": "string",    "type": "structured",    "updateTime": "2019-08-24T14:15:22Z",    "voice": {      "enabled": true    }  }}