Height Users API
The Users API from Height — 3 operation(s) for users.
The Users API from Height — 3 operation(s) for users.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
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.curl "https://apis.io/api/v1/apis/height-users-api"
curl "https://apis.io/api/v1/apis?limit=25"
Discovery needs no key. Ratings and market analysis are Pro.
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: 3.2.0
info:
title: Height APP Users 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: Users
paths:
/users:
get:
tags:
- Users
summary: Get all users
operationId: getUsers
x-codeSamples:
- lang: JavaScript
label: SDK
source: 'const height = new Height({secretKey: ''secret_your-key''});
height.users.all();'
responses:
'200':
description: Successful operation
content:
application/json:
schema:
$ref: '#/components/schemas/ListAllUsersResponse'
/users/:id:
get:
tags:
- Users
summary: Get a user
operationId: getUser
x-codeSamples:
- lang: JavaScript
label: SDK
source: 'const height = new Height({secretKey: ''secret_your-key''});
height.users.get({...});'
parameters:
- name: id
in: path
required: true
schema:
type: string
format: uuid
responses:
'200':
description: Successful operation
content:
application/json:
schema:
$ref: '#/components/schemas/UserObject'
/users/me:
get:
tags:
- Users
summary: Get the current user
operationId: getCurrentUser
x-codeSamples:
- lang: JavaScript
label: SDK
source: 'const height = new Height({secretKey: ''secret_your-key''});
height.users.me();'
responses:
'200':
description: Successful operation
content:
application/json:
schema:
$ref: '#/components/schemas/UserObject'
components:
schemas:
EnabledUserObject:
type: object
properties:
id:
type: string
format: uuid
description: The unique ID of the user.
model:
type: string
description: The model is always `user`.
enum:
- user
state:
type: string
description: The state of the user.
enum:
- enabled
- invited
example: enabled
email:
type: string
description: The email of the user.
username:
type: string
description: The username of the user, only available for `enabled` users.
firstname:
type: string
description: The first name of the user, only available for `enabled` users.
lastname:
type: string
description: The last name of the user, only available for `enabled` users.
access:
type: string
description: The access level of the user.
enum:
- member
- guest
- anonymous
example: member
createdAt:
type: string
format: date-time
description: The date and time the user was created, see [Date formats](https://www.notion.so/API-documentation-643aea5bf01742de9232e5971cb4afda).
example: '2023-02-18T10:15:00Z'
pictureUrl:
type:
- string
- 'null'
description: The URL of the user's picture, if available.
example: https://example.com/user.jpg
required:
- id
- model
- state
- email
- access
- createdAt
- username
- firstname
- lastname
UserObject:
allOf:
- $ref: '#/components/schemas/EnabledUserObject'
- $ref: '#/components/schemas/InvitedUserObject'
ListAllUsersResponse:
type: object
properties:
list:
type: array
items:
$ref: '#/components/schemas/UserObject'
description: The list of users.
InvitedUserObject:
type: object
properties:
id:
type: string
format: uuid
description: The unique ID of the user.
model:
type: string
description: The model is always `user`.
enum:
- user
state:
type: string
description: The state of the user.
enum:
- enabled
- invited
example: enabled
email:
type: string
description: The email of the user.
access:
type: string
enum:
- member
- guest
- anonymous
example: member
createdAt:
type: string
format: date-time
description: The date and time the user was created, see [Date formats](https://www.notion.so/API-documentation-643aea5bf01742de9232e5971cb4afda).
example: '2023-02-18T10:15:00Z'
pictureUrl:
type: string
description: The URL of the user's picture, if available.
example: https://example.com/user.jpg
required:
- id
- model
- state
- email
- access
- createdAt
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