Viviot.Api

<back to all web services

CreateTaskLists

Requires Authentication
Requires any of the roles:Admin, TenantAdmin, TaskAdmin
The following routes are available for this service:
POST/tasklistsCreates one or more task lists.
CreateTaskLists Parameters:
NameParameterData TypeRequiredDescription
AccessTemplateGroupIdbodystringNoAccess Template Id. Set a value in case the TaskList is relevant to a specific smartspace.
SaveAsTemplatebodybooleanNoFlag indicating if a template should be saved based on the tasklist being created.
TasksbodyarrayNoTasks to create as part of the task list.
CommonTaskListApi Parameters:
NameParameterData TypeRequiredDescription
AccessTemplateIdformstringNoAccess Template Id. Set a value in case the TaskList is relevant to a specific smartspace.
PriorityformTaskListPriorityYesTaskListPriority, ranking this TaskList amid others.

Allowable Values

  • None
  • VeryLow
  • Low
  • Medium
  • High
  • VeryHigh
  • Critical
StartformstringNoThe optional start time of the task list.
DeadlineformstringNoThe optional deadline of the task list.
CategoriesformarrayNoTags under which to categorize the tasklist.
RecurrenceConfigurationformstringNoRecurrence configuration in iCalendar format.
ShiftIdformstringNoID of a shift that this task list is linked to. If no shift is selected, a user or team must be selected.
TeamIdformstringNoID of a team that this task list is linked to. If no team is selected, a user or shift must be selected.
BusinessUserIdformintegerNoID of a business user that this task list is directly linked to. If no business user is selected, a team or shift must be selected.
StatusformStatusYesThe status/progress of the task list.

Allowable Values

  • ToDo
  • InProgress
  • Incomplete
  • Done
NameformstringYesThe base name for this (group of) lists.
InstructionsformstringNoInstructions on how to complete the task list.
BaseRequest Parameters:
NameParameterData TypeRequiredDescription
VersionformintegerNoApi version
TaskListPriority Enum:
NameValue
None0
VeryLow10
Low20
Medium30
High40
VeryHigh50
Critical60
Category Enum:
NameValue
Cleaning10
Maintenance20
Disinfection30
Inspection40
Security50
Status Enum:
NameValue
ToDo0
InProgress10
Incomplete30
Done40
CommonBaseTask Parameters:
NameParameterData TypeRequiredDescription
NameformstringYesTask name.
DescriptionformstringNoTask description.
CompleteWithTagformbooleanYesFlag indicating whether the task completion must be marked by scanning a NFC tag.
NfcCodeformstringNoNFC code of the tag.
TaskTypeformTaskTypeYesThe type of task.

Allowable Values

  • Standard
OrderformintegerNoThe position of the task within its task list.
TaskStatusformTaskStatusYesCurrent status of the task.

Allowable Values

  • ToDo
  • InProgress
  • Incomplete
  • Done
TaskListIdformstringYesThe ID of the TaskList to which this Task belongs.
TaskType Enum:
NameValue
Standard0
TaskListsCreatedResponse Parameters:
NameParameterData TypeRequiredDescription
IdsformIEnumerable<Guid>No
BaseResponse Parameters:
NameParameterData TypeRequiredDescription
ResponseStatusformResponseStatusNo

To override the Content-type in your clients, use the HTTP Accept Header, append the .csv suffix or ?format=csv

HTTP + CSV

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

POST /tasklists HTTP/1.1 
Host: api.4spaces.io 
Accept: text/csv
Content-Type: text/csv
Content-Length: length

{Unable to show example output for type 'CreateTaskLists' using the custom 'csv' filter}One or more errors occurred. (Unable to cast object of type 'ServiceStack.Host.BasicResponse' to type 'ServiceStack.Host.NetCore.NetCoreResponse'.)
HTTP/1.1 200 OK
Content-Type: text/csv
Content-Length: length

{Unable to show example output for type 'TaskListsCreatedResponse' using the custom 'csv' filter}One or more errors occurred. (Unable to cast object of type 'ServiceStack.Host.BasicResponse' to type 'ServiceStack.Host.NetCore.NetCoreResponse'.)