# UserTasks
#Available from v.3.11.0 User tasks are used to create tasks for users in the system.
GET /usertasks Get all user tasks in the system
{
"Page": 1,
"PageSize": 100,
"Total": 2,
"UserTasks": [
{
"Uid": "9fb6b427-07f7-4b01-a04b-851eaf2d65c0",
"Created": "2022-12-20T10:53:11+01:00",
"CreatedBy": "5",
"Title": "Please add images to these products",
"Description": "I have added products, which are missing their primary image. They should all be available in our DAM for you to choose",
"Status": 2,
"AssignedUsers": [
"12"
],
"AssignedUserGroups": [],
"Comments": [],
"AttachedEntities": [
{
"EntityType": 1,
"EntityId": "1022",
"Status": 0
},
{
"EntityType": 1,
"EntityId": "1023",
"Status": 0
},
{
"EntityType": 1,
"EntityId": "1024",
"Status": 0
}
]
},
{
"Uid": "eb284804-a977-47f9-acda-04f3ea3bbb96",
"Created": "2023-01-02T13:57:05+01:00",
"CreatedBy": "3",
"Deadline": "2023-01-13T23:00:00+01:00",
"Title": "Missing descriptions on products and variants",
"Description": "There are a few products and variants which are missing descriptions in several languages. Use the english texts to translate from",
"Status": 0,
"AssignedUsers": [
"5",
"10"
],
"AssignedUserGroups": [],
"Comments": [
{
"Uid": "8767bfd8-195e-4370-ae74-53f99b76bd4b",
"Comment": "Okay, I will have a look right away. Is it okay to just use standard LanguageWire translations to begin with?",
"UserId": "5",
"Name": "John Doe",
"Created": "2023-01-03T08:41:08+01:00",
"IsSystemGenerated": false
}
],
"AttachedEntities": [
{
"EntityType": 1,
"EntityId": "1022",
"Status": 0
},
{
"EntityType": 1,
"EntityId": "1023",
"Status": 0
},
{
"EntityType": 1,
"EntityId": "1024",
"Status": 0
},
{
"EntityType": 2,
"EntityId": "5665",
"Status": 0
},
{
"EntityType": 2,
"EntityId": "4986",
"Status": 0
}
]
}
]
}
Request parameters
Property name | Parameter type | Data type | Description |
---|---|---|---|
page | query | integer |
Response status OK (200)
Property name | Data type | Description |
---|---|---|
Page | integer |
Page of the paged result |
PageSize | integer |
Page size of the paged result |
Total | integer |
Total number of user tasks |
UserTasks | array : UserTask |
User tasks on this pagge |
Property name | Data type | Description |
---|---|---|
Uid | string |
Unique id of the task |
Created | string |
Timestamp at which the task was created |
CreatedBy | string |
Id of the user who created the task |
Deadline | string |
Deadline for the task, if any |
Title | string |
Title for the task |
Description | string |
Description of the task |
Status | string |
Current status of the task |
AssignedUsers | array |
Ids of specific users to which the task is assigned |
AssignedUserGroups | array |
Ids of user groups to which the task is assigned |
Comments | array : UserTaskComment |
List of comments made by users to the task |
AttachedEntities | array : UserTaskEntity |
Entities in the system attached to this task |
Files | array |
Property name | Data type | Description |
---|---|---|
Uid | string |
Unique id of the comment |
Comment | string |
The actual comment |
UserId | string |
Id of the user who created the comment |
Name | string |
Name of the user who created the comment |
Created | string |
Timestamp of when the comment was created |
LastModified | string |
Timestamp for the last modification of the comment |
IsSystemGenerated | boolean |
Indicates whether the comment was generated automatically by the system |
Property name | Data type | Description |
---|---|---|
EntityType | string |
Type of entity |
EntityId | string |
Id of entity, represented as string to support non-integer ids in the future |
Status | string |
Status for the attached entity on this task |
PUT /usertasks Update a user task
{
"Uid": "073af031-fc72-4ade-9708-1862c353dab3",
"Deadline": "2023-01-13T23:00:00+01:00",
"Title": "Images on products in poor quality",
"Description": "The images on some products seem to be of poor quality (see attached). Will you please go through them and see if we can get better images?",
"Status": 2,
"AssignedUsers": [
"5, 10"
],
"AttachedEntities": [
{
"EntityType": 1,
"EntityId": "1022"
},
{
"EntityType": 1,
"EntityId": "1023"
},
{
"EntityType": 1,
"EntityId": "1024"
}
]
}
Request parameters
Property name | Parameter type | Data type | Description |
---|---|---|---|
userTask | body | object : UpdateUserTaskModel |
User task to update |
Property name | Data type | Description |
---|---|---|
Uid | string |
Unique id of the task |
Deadline | string |
Deadline for the task, if any |
Title | string |
Title for the task |
Description | string |
Description of the task |
Status | string |
Current status of the task |
AssignedUsers | array |
Ids of specific users to which the task is assigned |
AssignedUserGroups | array |
Ids of user groups to which the task is assigned |
AttachedEntities | array : UserTaskEntityModel |
Entities in the system attached to this task |
Property name | Data type | Description |
---|---|---|
EntityType | string |
Type of entity |
EntityId | string |
Id of entity, represented as string to support non-integer ids in the future |
Response status OK (200)
POST /usertasks Create a user task
{
"Uid": "073af031-fc72-4ade-9708-1862c353dab3",
"AssignedUsers": [
"5, 10"
],
"Title": "Images on products in poor quality",
"Description": "The images on some products seem to be of poor quality (see attached). Will you please go through them and see if we can get better images?",
"Deadline": "2023-01-13T23:00:00+01:00",
"AttachedEntities": [
{
"EntityType": 1,
"EntityId": "1022"
},
{
"EntityType": 1,
"EntityId": "1023"
},
{
"EntityType": 1,
"EntityId": "1024"
}
]
}
Request parameters
Property name | Parameter type | Data type | Description |
---|---|---|---|
userTask | body | object : CreateUserTaskModel |
User task to create |
Property name | Data type | Description |
---|---|---|
Uid | string |
Unique id of user task |
AssignedUserGroups | array |
Ids of user groups to which the task is assigned |
AssignedUsers | array |
Ids of specific users to which the task is assigned |
Title | string |
Title for the task |
Description | string |
Description of the task |
Deadline | string |
Deadline for the task, if any |
AttachedEntities | array : UserTaskEntityModel |
Entities in the system attached to this task |
Property name | Data type | Description |
---|---|---|
EntityType | string |
Type of entity |
EntityId | string |
Id of entity, represented as string to support non-integer ids in the future |
Response status OK (200)
DELETE /usertasks Delete a user task
Request parameters
Property name | Parameter type | Data type | Description |
---|---|---|---|
uid | query | string |
Unique id of user task to delete |
Response status OK (200)
GET /usertasks/{uid} Get a user task from its uid
{
"Uid": "eb284804-a977-47f9-acda-04f3ea3bbb96",
"Created": "2023-01-02T13:57:05+01:00",
"CreatedBy": "3",
"Deadline": "2023-01-13T23:00:00+01:00",
"Title": "Missing descriptions on products and variants",
"Description": "There are a few products and variants which are missing descriptions in several languages. Use the english texts to translate from",
"Status": 0,
"AssignedUsers": [
"5",
"10"
],
"AssignedUserGroups": [],
"Comments": [
{
"Uid": "8767bfd8-195e-4370-ae74-53f99b76bd4b",
"Comment": "Okay, I will have a look right away. Is it okay to just use standard LanguageWire translations to begin with?",
"UserId": "5",
"Name": "John Doe",
"Created": "2023-01-03T08:41:08+01:00",
"IsSystemGenerated": false
}
],
"AttachedEntities": [
{
"EntityType": 1,
"EntityId": "1022",
"Status": 0
},
{
"EntityType": 1,
"EntityId": "1023",
"Status": 0
},
{
"EntityType": 1,
"EntityId": "1024",
"Status": 0
},
{
"EntityType": 2,
"EntityId": "5665",
"Status": 0
},
{
"EntityType": 2,
"EntityId": "4986",
"Status": 0
}
]
}
Request parameters
Property name | Parameter type | Data type | Description |
---|---|---|---|
uid | path | string |
Unique id of user task to get |
Response status OK (200)
Property name | Data type | Description |
---|---|---|
Uid | string |
Unique id of the task |
Created | string |
Timestamp at which the task was created |
CreatedBy | string |
Id of the user who created the task |
Deadline | string |
Deadline for the task, if any |
Title | string |
Title for the task |
Description | string |
Description of the task |
Status | string |
Current status of the task |
AssignedUsers | array |
Ids of specific users to which the task is assigned |
AssignedUserGroups | array |
Ids of user groups to which the task is assigned |
Comments | array : UserTaskComment |
List of comments made by users to the task |
AttachedEntities | array : UserTaskEntity |
Entities in the system attached to this task |
Files | array |
Property name | Data type | Description |
---|---|---|
Uid | string |
Unique id of the comment |
Comment | string |
The actual comment |
UserId | string |
Id of the user who created the comment |
Name | string |
Name of the user who created the comment |
Created | string |
Timestamp of when the comment was created |
LastModified | string |
Timestamp for the last modification of the comment |
IsSystemGenerated | boolean |
Indicates whether the comment was generated automatically by the system |
Property name | Data type | Description |
---|---|---|
EntityType | string |
Type of entity |
EntityId | string |
Id of entity, represented as string to support non-integer ids in the future |
Status | string |
Status for the attached entity on this task |
PUT /usertasks/{uid}/comments Update a comment on a user task
{
"Uid": "c6a6fea3-163a-4a86-be2d-ace37e2b6691",
"Comment": "Super duper. I will have a look"
}
Request parameters
Property name | Parameter type | Data type | Description |
---|---|---|---|
uid | path | string |
Uid of user task |
comment | body | object : UpdateUserTaskCommentModel |
Comment to update |
Property name | Data type | Description |
---|---|---|
Uid | string | |
Comment | string |
Response status OK (200)
POST /usertasks/{uid}/comments Create a comment on a user task
{
"Uid": "c6a6fea3-163a-4a86-be2d-ace37e2b6691",
"Comment": "Super duper. I will have a look"
}
Request parameters
Property name | Parameter type | Data type | Description |
---|---|---|---|
uid | path | string |
Uid of user task |
comment | body | object : CreateUserTaskCommentModel |
Comment to add to user task |
Property name | Data type | Description |
---|---|---|
Uid | string |
Unique id of comment |
Comment | string |
Comment itself |
Response status OK (200)
DELETE /usertasks/{uid}/comments Delete a user task
Request parameters
Property name | Parameter type | Data type | Description |
---|---|---|---|
uid | path | string |
Uid of user task |
commentUid | query | string |
Unique id of comment to delete |
Response status OK (200)
POST /usertasks/batch Get a batch of user tasks by uids
[
{
"Uid": "eb284804-a977-47f9-acda-04f3ea3bbb96",
"Created": "2023-01-02T13:57:05+01:00",
"CreatedBy": "3",
"Deadline": "2023-01-13T23:00:00+01:00",
"Title": "Missing descriptions on products and variants",
"Description": "There are a few products and variants which are missing descriptions in several languages. Use the english texts to translate from",
"Status": 0,
"AssignedUsers": [
"5",
"10"
],
"AssignedUserGroups": [],
"Comments": [
{
"Uid": "8767bfd8-195e-4370-ae74-53f99b76bd4b",
"Comment": "Okay, I will have a look right away. Is it okay to just use standard LanguageWire translations to begin with?",
"UserId": "5",
"Name": "John Doe",
"Created": "2023-01-03T08:41:08+01:00",
"IsSystemGenerated": false
}
],
"AttachedEntities": [
{
"EntityType": 1,
"EntityId": "1022",
"Status": 0
},
{
"EntityType": 1,
"EntityId": "1023",
"Status": 0
},
{
"EntityType": 1,
"EntityId": "1024",
"Status": 0
},
{
"EntityType": 2,
"EntityId": "5665",
"Status": 0
},
{
"EntityType": 2,
"EntityId": "4986",
"Status": 0
}
]
}
]
Request parameters
Property name | Parameter type | Data type | Description |
---|---|---|---|
userTaskUids | body | array : string |
Response status OK (200)
Property name | Data type | Description |
---|---|---|
Uid | string |
Unique id of the task |
Created | string |
Timestamp at which the task was created |
CreatedBy | string |
Id of the user who created the task |
Deadline | string |
Deadline for the task, if any |
Title | string |
Title for the task |
Description | string |
Description of the task |
Status | string |
Current status of the task |
AssignedUsers | array |
Ids of specific users to which the task is assigned |
AssignedUserGroups | array |
Ids of user groups to which the task is assigned |
Comments | array : UserTaskComment |
List of comments made by users to the task |
AttachedEntities | array : UserTaskEntity |
Entities in the system attached to this task |
Files | array |
Property name | Data type | Description |
---|---|---|
Uid | string |
Unique id of the comment |
Comment | string |
The actual comment |
UserId | string |
Id of the user who created the comment |
Name | string |
Name of the user who created the comment |
Created | string |
Timestamp of when the comment was created |
LastModified | string |
Timestamp for the last modification of the comment |
IsSystemGenerated | boolean |
Indicates whether the comment was generated automatically by the system |
Property name | Data type | Description |
---|---|---|
EntityType | string |
Type of entity |
EntityId | string |
Id of entity, represented as string to support non-integer ids in the future |
Status | string |
Status for the attached entity on this task |