• Features
  • Pricing
Get Started

List TemplatesCreate TemplateGet TemplateUpdate TemplateDelete Template

POST /v1/templates

Create a new template by sending a JSON request body.

POST /v1/templates creates a new template.

Authentication

Send an organization API key in x-api-key or Authorization: Bearer <key>.

Request Body

Send a JSON object. name is required; all other fields are optional.

NameTypeRequiredDescription
namestringYesTemplate name, from 1 to 255 characters.
descriptionstring or nullNoShort template description.
authorstring (uuid) or nullNoUUID of the author.
labelIdsarray of strings (uuid)NoLabels assigned to the template.
activebooleanNoWhether the template is active. Defaults to true.

Example

curl -X POST "https://api.blueputto.com/v1/templates" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "content-type: application/json" \
  -d '{"name":"Condition report","description":"Reusable condition-report template"}'

Success Response

201 Created

{
  "data": {}
}

Error Responses

  • 400 Bad Request
  • 401 Unauthorized
  • 404 Not Found
  • 429 Too Many Requests

GET /v1/templates

List templates with pagination and an active-only filter.

GET /v1/templates/{templateId}

Retrieve a single template by its UUID.

On this page

AuthenticationRequest BodyExampleSuccess ResponseError Responses