Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Teachable Users API

User management endpoints

Teachable Users API is one of 10 APIs that Teachable publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Users. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, rate-limit docs, a getting-started guide, and a changelog.

This API exposes 4 operations across 2 paths, and defines 10 schemas. It is described by OpenAPI 3.0.3, at version 1.

Requests are made against a single base URL, https://developers.teachable.com/v1.

4 operations 2 paths 10 schemas 2 GET1 PATCH1 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
1
Base URL
https://developers.teachable.com/v1
Authentication
API Key
Terms of Service
Resource Areas
1

Authentication & Security 1

Teachable Users API declares 1 security scheme for authenticating requests. An API key is passed in the header as apiKey (ApiKeyAuth). By default, every request must be authenticated.

  • ApiKeyAuth — API key for Admin API authentication. Available on Growth plan and above.

Paths & Operations 4

Across 2 paths, the API surfaces 4 operations — 2 GET, 1 PATCH, 1 POST. Each is listed below with its method, path, parameters, and response codes.

Users 4

User management endpoints

GET
/users
List users
listUsers 4 params → 200
POST
/users
Create a user
createUser body → 201400
GET
/users/{user_id}
Get a user
getUser 1 param → 200404
PATCH
/users/{user_id}
Update a user
updateUser 1 param body → 200404

Schemas 10

The contract defines 10 schemas that model the data the API accepts and returns. The most detailed are UserCourse (6 properties), PaginationMeta (6 properties), CreateUserRequest (4 properties), UserSummary (3 properties). Each schema is shown below with its type and property counts.

UserDetail
ErrorResponse
object
1 property
PaginationMeta
object
6 properties
UserCourse
object
6 properties
UpdateUserRequest
object
2 properties
UsersListResponse
object
2 properties
UserDetailResponse
object
1 property
CreateUserRequest
object
4 properties 1 required
UserSummary
object
3 properties
UserTag
object
1 property

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

teachable-users-api-openapi.yml Raw ↑

Other APIs Teachable publishes across the network.

Teachable Courses API
Teachable CurrentUser API
Teachable Enrollments API
Teachable Lectures API
Teachable PricingPlans API
Teachable Quizzes API
Teachable Transactions API
Teachable Videos API
Teachable Webhooks API