Retrieves one template by ID or a filtered, paginated list of templates. A list contains brief template details; requesting a template by ID also returns its content and ordinary labels.
https://api.doboard.com/{account_id}/task_template_get
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_id |
int | No | Not set | Positive template ID. When supplied, retrieves one template. |
template_group_id |
int | No | Not set | List filter by Template Group. Use 0 for ungrouped templates; omit to include all groups. |
search |
string | No | Empty string | List filter by catalog name. |
status |
enum | No | ACTIVE |
ACTIVE or REMOVED. |
start |
int | No | 0 |
Nonnegative list offset. |
length |
int | No | 100 |
List size: 10, 25, 50 or 100. |
GET https://api.doboard.com/42/task_template_get?session_id=YOUR_SESSION_ID&template_group_id=3&search=Bug&start=0&length=25
Response:
{
"data": {
"operation_status": "SUCCESS",
"templates": [
{
"template_id": 101,
"template_group_id": 3,
"name": "Bug report",
"task_name": "New bug",
"status": "ACTIVE",
"created": "2026-10-12 09:00:00",
"updated": "2026-10-12 09:00:00"
}
],
"records_filtered": 1
}
}
records_filtered is the total number of matching templates before pagination. An empty list is a successful response with templates: [].
GET https://api.doboard.com/42/task_template_get?session_id=YOUR_SESSION_ID&template_id=101
Response:
{
"data": {
"operation_status": "SUCCESS",
"templates": [
{
"template_id": 101,
"template_group_id": 3,
"name": "Bug report",
"task_name": "New bug",
"content": "<p>Steps to reproduce:</p>",
"label_ids": [12, 35],
"status": "ACTIVE",
"created": "2026-10-12 09:00:00",
"updated": "2026-10-12 09:00:00"
}
]
}
}
When template_id is supplied, list-only filters and pagination do not apply. The status filter still applies: use status=REMOVED to retrieve a removed template.
| 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 |
9002 |
Template Not Found |
The template does not exist or does not match the requested status. |
200 |
0 |
Internal API Error |
An operation could not be completed. |
9001 messages:
{field} must be an integer between {minimum} and 4294967295status must be in ('ACTIVE','REMOVED')search must be a UTF-8 stringlength must be in (10,25,50,100)Placeholders 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 and group identifiers, status, offset and list size. A missing template or one that does not match the requested status returns a not-found error.
template_id descending. In search, % and _ are SQL wildcard characters.name is the catalog name; task_name is the default name used when creating a task.template_group_id: null means “Ungrouped”.