Lists / Get one by key
Return specific list by unique_key.
Route: /api/{tenant:minlength(2)}/v{version:apiVersion}/lists/key/{unique_key}
Method: GET
Authorisation: Minimum role: USER
Request Arguments
Name | Type | Source |
---|---|---|
unique_key | String | |
include_view_states | Boolean | |
include_fields | Boolean | |
include_fields_multi_options | Boolean |
Request body example
Response object
Response status: 200 (OK)
Response type: DTO_list
Other response statuses: 400 (BadRequest), 403 (Forbidden)
Response body example
DTO_list
Name | Type | ReadOnly | Description |
---|---|---|---|
list_fields | DTO_list_field[] | List fields | |
group_access | DTO_group_access[] | Group access | |
sys_tags | DTO_reference[] | Label can be used on POST/PUT to create new tags | |
created_by | DTO_reference_user | ReadOnly | Created by |
last_updated_by | DTO_reference_user | ReadOnly | Last updated by |
id | Int32 | ReadOnly | Leave empty on input |
type | ENUM list_type | ReadOnly | Type |
highest_group_permission | ENUM group_permission | ReadOnly | Highest group permission |
name | String | Name | |
unique_key | String | Unique key | |
description | String | Description | |
entries_count | Int32 | Entries count | |
created | DateTime | ReadOnly | Created |
last_updated | DateTime | ReadOnly | Last updated |
DTO_list_field
Name | Type | ReadOnly | Description |
---|---|---|---|
id | Int32 | Id | |
is_required | Boolean | Is required | |
is_unique_identifier | Boolean | Is unique identifier |
DTO_group_access
Name | Type | ReadOnly | Description |
---|---|---|---|
permission | ENUM group_permission | Permission | |
id | Int32 | Id | |
label | Object | ReadOnly | Label |
DTO_reference
Name | Type | ReadOnly | Description |
---|---|---|---|
id | Int32 | The id of the reference | |
label | Object | ReadOnly | Name/Label from referenced object. |
DTO_reference_user
Name | Type | ReadOnly | Description |
---|---|---|---|
profile_pic | String | ReadOnly | Profile pic |
String | ReadOnly | ||
id | Int32 | Id | |
label | Object | ReadOnly | Label |
ENUM group_permission
Value | Name | Description |
---|---|---|
0 | UNKNOWN | UNKNOWN |
1 | READ | Read only |
2 | EDIT | Edit |
3 | FULL | Full |
ENUM list_type
Value | Name | Description |
---|---|---|
0 | UNKNOWN | UNKNOWN |
1 | CUSTOM | CUSTOM |
2 | SYS_TAGS | SYS_TAGS |
3 | SYS_TICKET_STATUSES | SYS_TICKET_STATUSES |
4 | SYS_TICKET_PRIORITIES | SYS_TICKET_PRIORITIES |
5 | SYS_TICKET_TYPES | SYS_TICKET_TYPES |
6 | SYS_TICKET_FORM_TYPES | SYS_TICKET_FORM_TYPES |
7 | SYS_KB_TYPE | SYS_KB_TYPE |
9 | SYS_FILES | SYS_FILES |
10 | SYS_MULTI_OPTIONS | SYS_MULTI_OPTIONS |