Creates a group for organizing task templates. A Template Group is a catalog grouping, rather than a project or Board.
https://api.doboard.com/{account_id}/task_template_group_add
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. |
name |
string | Yes | — | Nonempty group name, maximum 128 characters. |
order_id |
int | No | 0 |
Group display order, from 0 to 4294967295. |
POST /42/task_template_group_add HTTP/1.1
Host: api.doboard.com
Content-Type: application/x-www-form-urlencoded
session_id=YOUR_SESSION_ID&name=Support&order_id=1000
This example creates the group “Support” with display order 1000.
Successful response:
{
"data": {
"operation_status": "SUCCESS",
"template_group_id": 3
}
}
template_group_id is the identifier of the created group. New groups have status ACTIVE.
| 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 |
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} charactersPlaceholders 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 a nonempty name within its length limit and an integer order_id within the supported range.