Form

All the endpoints that can be called on the Form controller.

Endpoints that require the FORM_READ permission:

• GET index

• GET item

• GET getFormForTicket

Endpoints that require the FORM_CUD permission:

• POST index

• PUT item

• DELETE item

Additionally, PUT saveFormFields requires the FORM_SAVE permission.

index

get

Returns all of the existing forms.

Authorizations

apiKey

apiKeystringRequired

Query parameters

querystring · min: 1OptionalDefault: ""Pattern: ^[0-9a-zA-Z ]+$

itemStartnumberOptionalDefault: 0

itemLimitnumber · max: 9999OptionalDefault: 15

Responses

200Success

No content

get

/api/v2/form

HTTPcURLJavaScriptPython

GET /api/v2/form HTTP/1.1
Host: {{base_url}}
apiKey: YOUR_API_KEY
Accept: */*

200Success

No content

index

post

Creates a new form for this brand.

Authorizations

apiKey

apiKeystringRequired

Body

multipart/form-data

brand_idnumberRequired

titlestring · min: 2RequiredPattern: ^[a-zA-Z0-9 ]+$

Responses

200Success

No content

post

/api/v2/form

HTTPcURLJavaScriptPython

POST /api/v2/form HTTP/1.1
Host: {{base_url}}
apiKey: YOUR_API_KEY
Content-Type: multipart/form-data
Accept: */*
Content-Length: 29

{
  "brand_id": 1,
  "title": "text"
}

200Success

No content

item

get

Returns this form by its ID.

Optionally, you can send a ticket ID with it to get the form values for that ticket.

Authorizations

apiKey

apiKeystringRequired

Path parameters

idnumberRequired

Query parameters

ticketIDnumberOptional

Responses

200Success

No content

get

/api/v2/form/{id}

HTTPcURLJavaScriptPython

GET /api/v2/form/{id} HTTP/1.1
Host: {{base_url}}
apiKey: YOUR_API_KEY
Accept: */*

200Success

No content

item

put

Updates this form by its ID.

Authorizations

apiKey

apiKeystringRequired

Path parameters

idnumberRequired

Body

application/x-www-form-urlencoded

brand_idnumberRequired

titlestring · min: 2RequiredPattern: ^[a-zA-Z0-9 ]+$

Responses

200Success

No content

put

/api/v2/form/{id}

HTTPcURLJavaScriptPython

PUT /api/v2/form/{id} HTTP/1.1
Host: {{base_url}}
apiKey: YOUR_API_KEY
Content-Type: application/x-www-form-urlencoded
Accept: */*
Content-Length: 29

"brand_id=1&title='text'"

200Success

No content

item

delete

Permanently deletes this form by its ID.

Authorizations

apiKey

apiKeystringRequired

Path parameters

idnumberRequired

Body

application/x-www-form-urlencoded

descriptionstringOptional

Optional parameter if you want to send a description for deletion.

Responses

200Success

No content

delete

/api/v2/form/{id}

HTTPcURLJavaScriptPython

DELETE /api/v2/form/{id} HTTP/1.1
Host: {{base_url}}
apiKey: YOUR_API_KEY
Content-Type: application/x-www-form-urlencoded
Accept: */*
Content-Length: 22

"description='text'"

200Success

No content

getFormForTicket

get

Returns the form(s) for this ticket.

Authorizations

apiKey

apiKeystringRequired

Query parameters

ticketIDnumberRequired

Responses

200Success

No content

get

/api/v2/form/getFormForTicket

HTTPcURLJavaScriptPython

GET /api/v2/form/getFormForTicket?ticketID=1 HTTP/1.1
Host: {{base_url}}
apiKey: YOUR_API_KEY
Accept: */*

200Success

No content

saveFormFields

put

Saves the values of the form fields of this ticket.

Authorizations

apiKey

apiKeystringRequired

Body

application/x-www-form-urlencoded

ticketIDnumberRequired

Responses

200Success

No content

put

/api/v2/form/saveFormFields

HTTPcURLJavaScriptPython

PUT /api/v2/form/saveFormFields HTTP/1.1
Host: {{base_url}}
apiKey: YOUR_API_KEY
Content-Type: application/x-www-form-urlencoded
Accept: */*
Content-Length: 72

"ticketID=1&fields=[{'formFieldID':'text','formFieldValue':'text'}]"

200Success

No content