HumHub - Tasks API (1.0.0)

Download OpenAPI specification:

E-mail: info@humhub.com License: AGPLv2

Welcome to the HumHub tasks module API reference.

Tasks

Find all tasks

query Parameters
page
integer >= 0

The number of page of the result set.

limit
integer [ 1 .. 50 ]
Default: 20

The numbers of items to return per page.

Responses

Response samples

Content type
{
  • "total": 76,
  • "page": 1,
  • "pages": 8,
  • "links": {
    },
  • "results": [
    ]
}

Find all tasks by container

path Parameters
id
required
integer

ID of content container

query Parameters
page
integer >= 0

The number of page of the result set.

limit
integer [ 1 .. 50 ]
Default: 20

The numbers of items to return per page.

Responses

Response samples

Content type
{
  • "total": 76,
  • "page": 1,
  • "pages": 8,
  • "links": {
    },
  • "results": [
    ]
}

Deletes a tasks by container

path Parameters
id
required
integer

The id of content container

Responses

Response samples

Content type
application/json
{
  • "code": 200,
  • "message": "Records successfully deleted!"
}

Task

Create new task

path Parameters
id
required
integer

The id of content container

Request Body schema: application/json

Task information

required
object
required
object
object (Content)

Responses

Request samples

Content type
application/json
{
  • "Task": {
    },
  • "TaskForm": {
    },
  • "content": {
    }
}

Response samples

Content type
application/json
{
  • "id": 6,
  • "title": "Space task by API",
  • "description": "Space task by API description",
  • "status": 1,
  • "start_datetime": "2019-02-27 10:00:00",
  • "end_datetime": "2019-02-28 17:59:00",
  • "scheduling": 1,
  • "all_day": 0,
  • "reminders": [
    ],
  • "max_users": null,
  • "color": null,
  • "task_list": {
    },
  • "cal_mode": 1,
  • "review": 1,
  • "created_at": "2019-03-05 15:35:02",
  • "created_by": {},
  • "content": {
    },
  • "percentage": 0,
  • "checklist": [
    ],
  • "assigned_users": [],
  • "responsible_users": []
}

Get task by id

path Parameters
id
required
integer

The id of the task

Responses

Response samples

Content type
application/json
{
  • "id": 6,
  • "title": "Space task by API",
  • "description": "Space task by API description",
  • "status": 1,
  • "start_datetime": "2019-02-27 10:00:00",
  • "end_datetime": "2019-02-28 17:59:00",
  • "scheduling": 1,
  • "all_day": 0,
  • "reminders": [
    ],
  • "max_users": null,
  • "color": null,
  • "task_list": {
    },
  • "cal_mode": 1,
  • "review": 1,
  • "created_at": "2019-03-05 15:35:02",
  • "created_by": {},
  • "content": {
    },
  • "percentage": 0,
  • "checklist": [
    ],
  • "assigned_users": [],
  • "responsible_users": []
}

Update task by id

path Parameters
id
required
integer

The id of the task

Request Body schema: application/json

Task information

required
object
required
object
object (Content)

Responses

Request samples

Content type
application/json
{
  • "Task": {
    },
  • "TaskForm": {
    },
  • "content": {
    }
}

Response samples

Content type
application/json
{
  • "id": 6,
  • "title": "Space task by API",
  • "description": "Space task by API description",
  • "status": 1,
  • "start_datetime": "2019-02-27 10:00:00",
  • "end_datetime": "2019-02-28 17:59:00",
  • "scheduling": 1,
  • "all_day": 0,
  • "reminders": [
    ],
  • "max_users": null,
  • "color": null,
  • "task_list": {
    },
  • "cal_mode": 1,
  • "review": 1,
  • "created_at": "2019-03-05 15:35:02",
  • "created_by": {},
  • "content": {
    },
  • "percentage": 0,
  • "checklist": [
    ],
  • "assigned_users": [],
  • "responsible_users": []
}

Delete the task by id

path Parameters
id
required
integer

The id of the task

Responses

Response samples

Content type
application/json
{
  • "code": 200,
  • "message": "Task successfully deleted!"
}

Task management

Change task status

path Parameters
id
required
integer

The id of the task

Request Body schema: application/json
required
title
integer <int64>
Enum: 1 2 3 5

Participant type:

  • 1 - pending.
  • 2 - in progress.
  • 3 - pending review.
  • 5 - completed.

Responses

Request samples

Content type
application/json
{
  • "title": 2
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "message": "Status successfully changed."
}

Revert task

path Parameters
id
required
integer

The id of the task

Request Body schema: application/json
required
title
integer <int64>
Enum: 1 2 3 4

Participant type:

  • 1 - pending.
  • 2 - in progress.
  • 3 - pending review.
  • 4 - completed.

Responses

Request samples

Content type
application/json
{
  • "title": 2
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "message": "Task successfully reverted."
}

Attach files to task

path Parameters
id
required
integer

The id of the task

Request Body schema: multipart/form-data
required
files
required
Array of file

The files to upload.

Responses

Response samples

Content type
application/json
{
  • "code": 200,
  • "message": "Files successfully uploaded."
}

Remove file from task

path Parameters
id
required
integer

The id of the task

fileId
required
integer

The id of file to remove.

Responses

Response samples

Content type
application/json
{
  • "code": 200,
  • "message": "File successfully removed."
}

Task List

Find all task lists by container

path Parameters
id
required
integer

ID of content container

query Parameters
page
integer >= 0

The number of page of the result set.

limit
integer [ 1 .. 50 ]
Default: 20

The numbers of items to return per page.

Responses

Response samples

Content type
{
  • "total": 76,
  • "page": 1,
  • "pages": 8,
  • "links": {
    },
  • "results": [
    ]
}

Create new task list

path Parameters
id
required
integer

The id of content container

Request Body schema: application/json

Task list information

required
object
required
object

Responses

Request samples

Content type
application/json
{
  • "TaskList": {
    },
  • "TaskListSettings": {
    }
}

Response samples

Content type
application/json
{
  • "id": 9,
  • "name": "Task list name",
  • "contentcontainer_id": 2,
  • "parent_id": null,
  • "color": "#d1ad0e",
  • "settings": {
    }
}

Get task list by id

path Parameters
id
required
integer

The id of the task list

Responses

Response samples

Content type
application/json
{
  • "id": 9,
  • "name": "Task list name",
  • "contentcontainer_id": 2,
  • "parent_id": null,
  • "color": "#d1ad0e",
  • "settings": {
    }
}

Update task list by id

path Parameters
id
required
integer

The id of the task list

Request Body schema: application/json

Task list information

required
object
required
object

Responses

Request samples

Content type
application/json
{
  • "TaskList": {
    },
  • "TaskListSettings": {
    }
}

Response samples

Content type
application/json
{
  • "id": 9,
  • "name": "Task list name",
  • "contentcontainer_id": 2,
  • "parent_id": null,
  • "color": "#d1ad0e",
  • "settings": {
    }
}

Delete the task list by id

path Parameters
id
required
integer

The id of the task list

Responses

Response samples

Content type
application/json
{
  • "code": 200,
  • "message": "Task list successfully deleted!"
}