List Templates

GET /api/v1/templates returns all templates accessible to your API key. Use this to discover available templates and their IDs before creating a project.

---

Authentication

Include your API key in the Authorization header of every request. API keys are scoped to a workspace and inherit the permissions of the user who created them.

Authorization: Bearer obv_your_api_key

Generate API keys in Settings → External Access.

---

Parameters

No query parameters. The endpoint returns all templates visible to your API key based on these visibility rules:

• Public — Available to everyone.

• Workspace — Shared with your workspace.

• Team — Shared with teams you belong to.

• Private — Created by you.

---

Response

A successful request returns 200 OK with an array of template objects.

{
  "templates": [
    {
      "id": "tpl_abc123",
      "name": "Sales Analysis Template",
      "description": "Analyze quarterly sales data"
    }
  ]
}

Field	Type	Description
templates	array	List of templates visible to your API key.
templates[].id	string	The template ID. Pass this to Create Project from Template to start a project.
templates[].name	string	The template's display name.
templates[].description	string	A short description of what the template does.

---

Code Example

curl -X GET https://api.app.obvious.ai/api/v1/templates \
  -H "Authorization: Bearer obv_your_api_key"

---

Errors

Status	Error	Cause
401	Authorization header required	Missing Authorization header.
401	Invalid authorization format	Header doesn't start with Bearer .
401	Invalid or expired API key	The API key doesn't exist or has been revoked.

---

Related Endpoints

• Create Project from Template — Create a new project from a template and start an autonomous agent session.

• Create Thread in Project — Run additional tasks on an existing project without creating a new one.