PUT api/survey/{id}

Request Information

URI Parameters

NameDescriptionTypeAdditional information
id

globally unique identifier

Required

Body Parameters

Survey
NameDescriptionTypeAdditional information
G_UID

Survey Identifier

Collection of byte

None.

Guid

Survey GUID

globally unique identifier

None.

Name

User-readable name of the survey

string

String length: inclusive between 0 and 60

StoreID

Store this survey will display in

integer

None.

ZoneID

Zone this survey will display in; null = all zones

integer

None.

CheckoutFormG_UID

Survey Identifier

Collection of byte

None.

CheckoutFormGuid

Survey Form GUID

globally unique identifier

None.

DisplayToWho

SurveyAnswerer

None.

DisplayWhen

DisplaySurveyWhen

None.

Start

date

None.

End

date

None.

Deleted

Soft deletion flag

boolean

None.

Updated

date

None.

PossibleIntegerResponses

List of possible integer/number answers that can be answered using this survey

Collection of integer

Relation. This field may not always be loaded or used for updates.

PossibleTextResponses

List of possible text answers that can be answered using this survey

Collection of string

Relation. This field may not always be loaded or used for updates.

PossibleGuidResponses

List of possible guid answers that can be answered using this survey

Collection of globally unique identifier

Relation. This field may not always be loaded or used for updates.

AllowsAllTextResponses

true if this survey allows all text-based answers; PossibleTextResponses will still be populated with any pre-configured text responses This is true if the surveys checkoutform contains a InputDisplayPanel as this allows any text to be inputted

boolean

Relation. This field may not always be loaded or used for updates.

SurveyForm

CheckoutForm

Relation. This field may not always be loaded or used for updates.

Request Formats

application/json, text/json

Sample:
{
  "g_UID": "IrXt3rgYoECbqaOQBnEAeA==",
  "guid": "deedb522-18b8-40a0-9ba9-a39006710078",
  "name": "sample string 1",
  "storeID": 2,
  "zoneID": 1,
  "checkoutFormG_UID": "RskcB8E9D0GO8lTZqoIeOw==",
  "checkoutFormGuid": "071cc946-3dc1-410f-8ef2-54d9aa821e3b",
  "displayToWho": 3,
  "displayWhen": 4,
  "start": "2025-06-14T06:38:07.9412058",
  "end": "2025-06-14T06:38:07.9412058",
  "deleted": true,
  "updated": "2025-06-14T06:38:07.9412058",
  "possibleIntegerResponses": [
    1,
    2
  ],
  "possibleTextResponses": [
    "sample string 1",
    "sample string 2"
  ],
  "possibleGuidResponses": [
    "88392e97-ea89-4d2b-b893-31c632c8f321",
    "e82b862d-9280-4c61-b6b8-41c18da5179d"
  ],
  "allowsAllTextResponses": true,
  "surveyForm": {
    "$id": "2",
    "id": 1,
    "g_UID": "w2lbIpKDPEydswIHxJW0bQ==",
    "guid": "225b69c3-8392-4c3c-9db3-0207c495b46d",
    "zoneID": 3,
    "storeID": 4,
    "name": "sample string 5",
    "formType": "sample string 6",
    "locationX": 1,
    "locationY": 1,
    "width": 1,
    "height": 1,
    "maximised": true,
    "resizable": true,
    "backgroundImage": "sample string 7",
    "backgroundColour": "sample string 8",
    "backgroundColourA": 1,
    "backgroundColourR": 1,
    "backgroundColourG": 1,
    "backgroundColourB": 1,
    "fontFamily": "sample string 9",
    "fontSize": 1.1,
    "fontStyle": 1,
    "previousForm": 1,
    "previousFormG_UID": "IDoeCU0FjkCHogW/xJxYiw==",
    "previousFormGuid": "091e3a20-054d-408e-87a2-05bfc49c588b",
    "nextForm": 1,
    "nextFormG_UID": "OHQ29X/PNEW8BX/4kZmajA==",
    "nextFormGuid": "f5367438-cf7f-4534-bc05-7ff891999a8c",
    "attributes": "sample string 10",
    "updated": "2025-06-14T06:38:07.9412058",
    "positioning": 1,
    "contentPanel": "sample string 11",
    "selectionMode": 1,
    "maximumSelections": 1,
    "alteredInStore": true,
    "deleted": true,
    "blueprintID": 1,
    "preserveLayout": true,
    "mainCheckoutFormName": "sample string 13",
    "nextCheckoutForm": {
      "$ref": "2"
    },
    "previousCheckoutForm": {
      "$ref": "2"
    },
    "buttons": [
      {
        "$id": "3",
        "id": 1,
        "checkoutFormID": 2,
        "checkoutFormG_UID": "Y3YwS/92z0iIkGsPVi8FYw==",
        "checkoutFormGuid": "4b307663-76ff-48cf-8890-6b0f562f0563",
        "identifier": "FMnNcZeeNUuJywezyHKYIQ==",
        "identifierGuid": "71cdc914-9e97-4b35-89cb-07b3c8729821",
        "name": "sample string 5",
        "plu": 1,
        "locationX": 1,
        "locationY": 1,
        "width": 1,
        "height": 1,
        "anchor": 1,
        "backgroundImage": "sample string 6",
        "backgroundImageID": 1,
        "backgroundImageUrl": "sample string 7",
        "topColour": 1,
        "textColour": 1,
        "bottomColour": 1,
        "borderColour": 1,
        "borderWidth": 1,
        "radius": 1,
        "gradientMode": 1,
        "dropShadow": true,
        "shadowWidth": 1,
        "highLightOnPush": true,
        "fontFamily": "sample string 8",
        "fontSize": 1.1,
        "fontStyle": 1,
        "textAlign": 1,
        "imageAlign": 1,
        "wordBreak": true,
        "verticalText": true,
        "buttonFunction": 1,
        "buttonValue": 1,
        "valueG_UID": "HwBJOq9gIEWjwuTeaiB6tQ==",
        "valueGuid": "3a49001f-60af-4520-a3c2-e4de6a207ab5",
        "buttonText": "sample string 10",
        "valueText": "sample string 11",
        "drawImageAndButton": true,
        "updated": "2025-06-14T06:38:07.9412058",
        "action": "sample string 12",
        "valueForm": {
          "$ref": "2"
        },
        "image": {
          "$id": "4",
          "name": "sample string 3.sample string 4",
          "imageID": 2,
          "imageName": "sample string 3",
          "imageExtension": "sample string 4",
          "lastUpdate": "2025-06-14T06:38:07.9412058",
          "imageData": "QEA=",
          "readOnly": true
        }
      },
      {
        "$ref": "3"
      }
    ],
    "panels": [
      {
        "$id": "5",
        "id": 1,
        "checkoutFormID": 2,
        "checkoutFormG_UID": "Ei77txd0IkiQ3ceWNVYPcQ==",
        "checkoutFormGuid": "b7fb2e12-7417-4822-90dd-c79635560f71",
        "panelType": "sample string 4",
        "name": "sample string 5",
        "locationX": 6,
        "locationY": 7,
        "width": 8,
        "height": 9,
        "anchor": 10,
        "fontFamily": "sample string 11",
        "fontSize": 12.1,
        "fontStyle": 13,
        "backgroundColour": 14,
        "textColour": 15,
        "attributes": "sample string 16"
      },
      {
        "$ref": "5"
      }
    ]
  }
}

application/xml

Sample:

Sample not available.

text/xml

Sample:

Sample not available.

application/x-www-form-urlencoded

Sample:

Sample not available.

Response Information

Resource Description

None.