Skip to main content

Retrieve an official bot template — GET /v3/bots/templates/{template_id}

Fetches an official Bot template, including the standard JSON `input_schema` required when creating a template run. If you only need a list of templates, use `GET /v3/bots/templates`.

Written by Maggie

GET /v3/bots/templates/{template_id}

Fetches an official Bot template, including the standard JSON `input_schema` required when creating a template run. If you only need a list of templates, use `GET /v3/bots/templates`.

Authentication

HTTPBearer

Parameters

  • template_id (path, string, required) — Public Bot template identifier.

Responses

200 — Bot template returned.

{  "template_id": "string",  "name": "string",  "description": "string",  "created_at": "2026-01-01T00:00:00Z",  "published_at": "2026-01-01T00:00:00Z",  "input_schema": {},  "recommend_desc": "string",  "detail_url": "string"}

400 — Bot template not found. Returns error code 10176.

{  "code": 123,  "msg": "Invalid task_id",  "data": null,  "ts": 1786634400000,  "time": "2026-08-13 18:00:00",  "traceId": "a1b2c3d4e5f6"}

500 — Internal Server Error

{  "code": 123,  "msg": "Invalid task_id",  "data": null,  "ts": 1786634400000,  "time": "2026-08-13 18:00:00",  "traceId": "a1b2c3d4e5f6"}

Did this answer your question?