Height Field Templates API
The Field Templates API from Height — 3 operation(s) for field templates.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/height-field-templates-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Height APP Field Templates API
description: Unofficial Open API 3.1 specification for Height App API.
contact:
email: gil@beomjun.kr
license:
name: MIT
url: http://www.apache.org/licenses/LICENSE-2.0.html
version: 1.0.0
servers:
- url: https://api.height.app
security:
- apiKey: []
tags:
- name: Field Templates
paths:
/fieldTemplates:
get:
tags:
- Field Templates
summary: List all field templates
operationId: listAllFieldTemplates
x-codeSamples:
- lang: JavaScript
label: SDK
source: 'const height = new Height({secretKey: ''secret_your-key''});
height.fieldTemplates.all();'
responses:
'200':
description: Successful operation
content:
application/json:
schema:
$ref: '#/components/schemas/ListAllFieldTemplatesResponse'
/fieldTemplates/:id/options:
post:
tags:
- Field Templates
summary: Create an option for a field template
description: This endpoint adds an option to a `select` or `labels` field template.
operationId: createFieldTemplateOption
x-codeSamples:
- lang: JavaScript
label: SDK
source: 'const height = new Height({secretKey: ''secret_your-key''});
height.fieldTemplates.createOption({...});'
parameters:
- name: id
in: path
description: field template id (UUID)
required: true
schema:
type: string
format: uuid
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/CreateFieldTemplateOptionRequest'
required: true
responses:
'200':
description: Successful operation
content:
application/json:
schema:
$ref: '#/components/schemas/FieldTemplateObject'
/fieldTemplates/:id/options/:optionId:
put:
tags:
- Field Templates
summary: Update or delete an option for a field template
operationId: updateFieldTemplateOption
x-codeSamples:
- lang: JavaScript
label: SDK
source: 'const height = new Height({secretKey: ''secret_your-key''});
height.fieldTemplates.updateOption({...});'
description: 'This endpoint updates or deletes an option to a `select` or `labels` field template.
The field template must be unlocked to use this endpoint. Locking and unlocking field templates is an enterprise feature.'
parameters:
- name: id
in: path
required: true
schema:
type: string
format: uuid
- name: optionId
in: path
required: true
schema:
type: string
format: uuid
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/UpdateFieldTemplateOptionRequest'
required: true
responses:
'200':
description: Successful operation
content:
application/json:
schema:
$ref: '#/components/schemas/FieldTemplateObject'
components:
schemas:
FieldTemplateObject:
type: object
properties:
id:
type: string
format: uuid
description: The unique id of the field template.
model:
type: string
enum:
- fieldTemplate
description: The model is always `fieldTemplate`.
name:
type: string
description: The name of the field template.
type:
type: string
description: 'Possible types:
- `text`: any text value attribute (i.e. Story Points)
- `labels`: used for tags for example
- `select`: used for priority, sprint,…
- `date`: used for due date,…
- `linkedTasks`: usually used for dependencies and so on
- `status`: the status attribute (only one field template of that type)'
enum:
- text
- labels
- select
- date
- linkedTasks
- status
labelSets:
type: array
description: An array of label sets, only available when the type of the field template is `status`.
items:
type: object
required:
- id
- model
- value
properties:
id:
type: string
format: uuid
description: The unique id of the field label set.
model:
type: string
enum:
- fieldLabelSet
description: The model is always `fieldLabelSet`.
value:
type: string
description: The name of the field label set.
labels:
type: array
description: Only available when the type of the field template is `labels`, `select` or `status`.
items:
type: object
required:
- id
- model
- value
- hue
- statusState
properties:
id:
type: string
description: UUID or string (backLog, inProgress and done are hard-coded).
model:
type: string
enum:
- fieldLabel
description: The model is always `fieldLabel`.
value:
type: string
description: The name of the label.
hue:
type: number
description: The hue of the label's color (between 0 and 360).
labelSetId:
type: string
format: uuid
description: The id of the label set this label belongs to, if any. Only if the type of field template is `status`.
statusState:
type: string
description: 'The state of the status, only available when the type of the field template is `status`.
Note that a task is considered as completed if its status has a state of `canceled` or `completed`.'
enum:
- default
- started
- blocked
- canceled
- completed
archive:
type: boolean
description: This attribute has been archived.
required:
- id
- model
- name
- type
- archive
CreateFieldTemplateOptionRequest:
type: object
required:
- value
properties:
value:
type: string
hue:
type: number
description: number between 0 and 360 (optional)
ListAllFieldTemplatesResponse:
type: object
required:
- list
properties:
list:
type: array
items:
$ref: '#/components/schemas/FieldTemplateObject'
UpdateFieldTemplateOptionRequest:
type: object
required:
- value
properties:
value:
type: string
hue:
type: number
description: number between 0 and 360 (optional)
deleted:
type: boolean
securitySchemes:
apiKey:
type: apiKey
name: Authorization
description: "The Height API uses API keys to authenticate requests. **You can view your API key in the Height settings under API**.\n ex: `api-key secret_1234`"
in: header
externalDocs:
description: Height official API Docs
url: https://www.notion.so/API-documentation-643aea5bf01742de9232e5971cb4afda