Changes a Template Group name, display order or status. Use this method to remove or restore a group.
https://api.doboard.com/{account_id}/task_template_group_update
account_id is the numeric organization identifier.
Supported methods: GET and POST. GET accepts query parameters; POST accepts the same parameters in an application/x-www-form-urlencoded request body.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
session_id |
string | Yes | — | Authenticated session ID. |
template_group_id |
int | Yes | — | Positive ID of the group to update. |
name |
string | No | Unchanged | Nonempty group name, maximum 128 characters. |
order_id |
int | No | Unchanged | Group display order, from 0 to 4294967295. |
status |
enum | No | Unchanged | ACTIVE or REMOVED. |
order_id=0 is a valid display order.status=REMOVED removes the group. Its active templates move to “Ungrouped”: their template_group_id becomes null.status=ACTIVE restores the group. Templates previously moved to “Ungrouped” are not automatically returned to it.Rename and reorder:
POST /42/task_template_group_update HTTP/1.1
Host: api.doboard.com
Content-Type: application/x-www-form-urlencoded
session_id=YOUR_SESSION_ID&template_group_id=3&name=Customer+support&order_id=2000
Remove:
POST /42/task_template_group_update HTTP/1.1
Host: api.doboard.com
Content-Type: application/x-www-form-urlencoded
session_id=YOUR_SESSION_ID&template_group_id=3&status=REMOVED
Restore:
POST /42/task_template_group_update HTTP/1.1
Host: api.doboard.com
Content-Type: application/x-www-form-urlencoded
session_id=YOUR_SESSION_ID&template_group_id=3&status=ACTIVE
Successful response:
{
"data": {
"operation_status": "SUCCESS",
"template_group_id": 3
}
}
| HTTP Code | error_no |
Message | Description |
|---|---|---|---|
401 |
401 |
session_id Unknown |
Missing or invalid session. |
403 |
403 |
Permission denied |
The request is forbidden. |
200 |
9001 |
Validation message (listed below) |
Missing, malformed or out-of-range input. |
200 |
9003 |
Template Group Not Found |
The group does not exist. |
200 |
0 |
Internal API Error |
An operation could not be completed. |
9001 messages:
{field} must be an integer between {minimum} and 4294967295{field} is required and must not exceed {limit} charactersstatus must be in ('ACTIVE','REMOVED')Empty inputPlaceholders in messages are replaced with the parameter name and its supported bounds.
Errors return data.operation_status="FAILED"; the same message is provided in error_message and data.operation_message.
The method validates:
template_group_id.