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 the appropriate forms from the Settings sections.

Queues

View a Queue

GET /queue/{id}?permissions={permissions}

Additional parameters

Name	Type	Description
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?permissions=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={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?permissions=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={topic}&type={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?topic=1&type=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"]
    }
]

Canned replies

View a Canned reply

GET /cannedReply/{id}

Sample code:

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

Response:

{
   "id": 1,
   "title": "Billing error",
   "text": "Most customers review their billing statements frequently to ensure that the payments posted to their accounts are correct.\nSometimes, these customers will find errors that your company has made."
}

List all Canned replies

GET /cannedReplies

Sample code:

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

Response:

[
    {
       "id": 1,
       "title": "Billing error",
       "text": "Most customers review their billing statements frequently to ensure that the payments posted to their accounts are correct.\nSometimes, these customers will find errors that your company has made."
    },
    {
       "id": 2,
       "title": "Apologize",
       "text": "We would like to apologize for any inconvenience. \n\nAlthough it is impossible to prevent errors completely, we will research this issue in order to determine its exact cause and to ensure that it does not happen again."
    }
]

Tags

View a Tag

GET /tag/{id}

Sample code:

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

Response:

{
    "id": 1,
    "name": "Service request"
}

List all Tags

GET /tags

Sample code:

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

Response:

[
    {
        "id": 1,
        "name": "Service request"
    },
    {
        "id": 2,
        "name": "Help/Assistance"
    },
    {
        "id": 3,
        "name": "Technical incident"
    }
]