Skip to main content

Overview

The Hitler API is a RESTful API that powers all Hitler functionality. Whether you’re building a custom integration, bot adapter, or admin tool, this API provides the foundation.

Base URL

Authentication

Most endpoints require authentication via JWT bearer token.
See Authentication for details on obtaining tokens.

Request Format

Headers

*Not required for public endpoints like login/register

Request Body

POST and PATCH requests expect JSON:

Response Format

Success Response

Error Response

Status Codes

Rate Limiting

Rate limit headers:

Pagination

List endpoints support pagination:
Response includes pagination info:

Filtering

Many endpoints support query filters:

SDKs & Libraries

TypeScript SDK

Official SDK for Node.js and browser

OpenAPI Spec

Download the OpenAPI 3.0 specificationDownload JSON

Interactive Docs

For interactive API exploration, visit our Swagger UI:

API Modules

Auth

Login, register, token management

Organizations

Organization management

Users

User CRUD operations

Tasks

Task and draft management

Chat

Conversational AI interface

Moods

Mood tracking

Flags

Wellbeing flags