Settings API

Note

The API data from the Settings section can be accessed only by Administrators. The data can be only listed and viewed. To update the settings data, use dedicated Settings section.

Queues

View a Queue

GET /queue/{id}/{permissions}

Parameters

Name	Type	Description
{id}	Integer	Queue ID
{permissions}	Integer	Show the queue permission's list: - 1 - yes - 0 - no

Sample code:

curl -X GET \
  https://acme.sympoq.com/app/desk/api/queue/1/1 \
  -H 'apikey: dWIeGMRlikMIle'

Response:

{
    "id": 1,
    "name": "Inbox",
    "sequence": 10,
    "permissions": [
      {
        "agent": 1,
        "role": "Queue Manager"
      },
      {
        "agent": 2,
        "role": "Agent"
      }
      {
        "agent": 3,
        "role": "Agent"
      }
    ]
}

List all Queues

GET /queues/{permissions}

Name	Type	Description
{permissions}	Integer	Show queue permission's list: - 1 - yes - 0 - no

Sample code:

curl -X GET \
  https://acme.sympoq.com/app/desk/api/queues/0 \
  -H 'apikey: dWIeGMRlikMIle'

Response:

[
    {
        "id": 1,
        "name": "Inbox",
        "sequence": 10
    },
    {
        "id": 2,
        "name": "Support",
        "sequence": 20
    },
    {
        "id": 3,
        "name": "Sales",
        "sequence": 30
    }
]

Topics

View a Topic

GET /topic/{id}

Sample code:

curl -X GET \
  https://acme.sympoq.com/app/desk/api/topic/1 \
  -H 'apikey: dWIeGMRlikMIle'

Response:

{
    "id": 1,
    "name": "General questions",
    "active": true
}

List all Topics

GET /topics

Sample code:

curl -X GET \
  https://acme.sympoq.com/app/desk/api/topics \
  -H 'apikey: dWIeGMRlikMIle' 

Response:

[
    {
        "id": 1,
        "name": "General questions",
        "active": true
    },
    {
        "id": 2,
        "name": "Sales",
        "active": true
    },
    {
        "id": 3,
        "name": "Technical support",
        "active": true
    },
    {
        "id": 4,
        "name": "Billing",
        "active": true
    }
]

Custom fields

List definition

GET /fields/{topic}/{type}

Filters

Name	Type	Description
topic	Integer	The Topic ID
type	Integer	Type of field: - 1 - Submission - 2 - Update

Sample code:

curl -X GET \
  https://acme.sympoq.com/app/desk/api/fields/1/1 \
  -H 'apikey: dWIeGMRlikMIle' 

Response:

[
    {
        "topic": 1,
        "field_name": "text_1",
        "label": "Invoice number",
        "required": true
    },
    {
        "topic": 1,
        "field_name": "text_2",
        "label": "Amount",
        "required": true
    },
    {
        "topic": 1,
        "field_name": "date_1",
        "label": "Due date",
        "required": false
    },
    {
        "topic": 1,
        "field_name": "select_list_1",
        "label": "Payment Method",
        "required": false,
        "values": ["Credit Card", "PayPal", "Wire Transfer"]
    }
]