PUT api/survey/{id}

Request Information

URI Parameters

Name	Description	Type	Additional information
id		globally unique identifier	Required

Body Parameters

Survey

Name	Description	Type	Additional 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": "DXpQJ1zb60C5qNatSwlxsA==",
  "guid": "27507a0d-db5c-40eb-b9a8-d6ad4b0971b0",
  "name": "sample string 1",
  "storeID": 2,
  "zoneID": 1,
  "checkoutFormG_UID": "/Ll4cK/af0+ZQPcwIH6NMw==",
  "checkoutFormGuid": "7078b9fc-daaf-4f7f-9940-f730207e8d33",
  "displayToWho": 3,
  "displayWhen": 4,
  "start": "2025-10-04T23:59:56.9177314",
  "end": "2025-10-04T23:59:56.9177314",
  "deleted": true,
  "updated": "2025-10-04T23:59:56.9177314",
  "possibleIntegerResponses": [
    1,
    2
  ],
  "possibleTextResponses": [
    "sample string 1",
    "sample string 2"
  ],
  "possibleGuidResponses": [
    "83d5c718-5321-4306-ab80-617523d58a5c",
    "661334a5-c787-48b9-aa5c-da5e493be5cb"
  ],
  "allowsAllTextResponses": true,
  "surveyForm": {
    "$id": "2",
    "id": 1,
    "g_UID": "eTl0VEy7yUKoqDAhq7C3/A==",
    "guid": "54743979-bb4c-42c9-a8a8-3021abb0b7fc",
    "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": "UYMbO7jw4kaLBI42W6Dc4w==",
    "previousFormGuid": "3b1b8351-f0b8-46e2-8b04-8e365ba0dce3",
    "nextForm": 1,
    "nextFormG_UID": "koMGpS6UxEGkbvybrJmXbA==",
    "nextFormGuid": "a5068392-942e-41c4-a46e-fc9bac99976c",
    "attributes": "sample string 10",
    "updated": "2025-10-04T23:59:56.9177314",
    "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": "ml30q0pz40+jJQWJSsqAww==",
        "checkoutFormGuid": "abf45d9a-734a-4fe3-a325-05894aca80c3",
        "identifier": "rbJvkGuUuku0YZYkN6BU0Q==",
        "identifierGuid": "906fb2ad-946b-4bba-b461-962437a054d1",
        "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": "7V2CWr/jNUyzHiisKiZ02A==",
        "valueGuid": "5a825ded-e3bf-4c35-b31e-28ac2a2674d8",
        "buttonText": "sample string 10",
        "valueText": "sample string 11",
        "drawImageAndButton": true,
        "updated": "2025-10-04T23:59:56.9177314",
        "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-10-04T23:59:56.9177314",
          "imageData": "QEA=",
          "readOnly": true
        }
      },
      {
        "$ref": "3"
      }
    ],
    "panels": [
      {
        "$id": "5",
        "id": 1,
        "checkoutFormID": 2,
        "checkoutFormG_UID": "bfBkHgvESkuoaafz7S10eA==",
        "checkoutFormGuid": "1e64f06d-c40b-4b4a-a869-a7f3ed2d7478",
        "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.