# Historis API API

**Canonical:** https://apis.io/apis/historis-app/historis-api-api/  
**Provider:** Historis — https://apis.io/providers/historis-app/  
**Base URL:** https://api.historis.app  
**Documentation:** https://historis.app/llms.txt

Historis API API is one of 2 APIs that [Historis](https://apis.io/providers/historis-app/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

Historis keeps a shared, event-based timeline of what happened, linked to the right people. This document describes the public REST API and the MCP transport. Most REST endpoints require a Supabase session JWT (a signed-in person) and are rate-limited per identity; a Supabase OAuth 2.1 access token

## Operations (60 of 107)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/health` | Liveness + schema health |
| POST | `/api/auth/signup` | Create an account |
| POST | `/api/auth/login` | Log in, returns a session (JWT) |
| POST | `/api/auth/logout` | Log out the current session |
| GET | `/api/auth/session` | Current session + user role |
| POST | `/api/auth/reset-password` | Send a password-reset email |
| POST | `/api/auth/change-password` | Change the current password |
| PATCH | `/api/auth/profile` | Update the user profile (name) |
| GET | `/api/auth/preferences` | Read user preferences (locale, timezone, density, theme) |
| PATCH | `/api/auth/preferences` | Update user preferences |
| DELETE | `/api/auth/account` | Delete the current account |
| POST | `/api/auth/refresh` | Rotate the refresh token |
| POST | `/api/bootstrap` | Create the default organization on first login |
| GET | `/api/persons` | List persons (paginated, filterable by tags/search) |
| POST | `/api/persons` | Create a person |
| GET | `/api/persons/{personId}` | Get a person and their events |
| PATCH | `/api/persons/{personId}` | Update a person |
| DELETE | `/api/persons/{personId}` | Delete a person |
| POST | `/api/persons/{personId}/relations` | Create a contact-to-contact relation from this person |
| DELETE | `/api/persons/{personId}/relations/{relatedPersonId}` | Delete a contact-to-contact relation |
| GET | `/api/events` | List events (paginated, filterable) |
| POST | `/api/events` | Create an event |
| GET | `/api/events/{eventId}` | Get an event |
| PATCH | `/api/events/{eventId}` | Update an event |
| DELETE | `/api/events/{eventId}` | Delete an event |
| POST | `/api/events/{eventId}/persons` | Link a person to an event |
| DELETE | `/api/events/{eventId}/persons/{personId}` | Unlink a person from an event |
| POST | `/api/events/{eventId}/related` | Link an event to another event |
| DELETE | `/api/events/{eventId}/related/{relatedEventId}` | Unlink a related event |
| GET | `/api/events/{parentId}/children` | List an event's child events (thread) |
| GET | `/api/search` | Full-text search across events and persons |
| GET | `/api/tags` | List tags with counters |
| POST | `/api/tags` | Create a tag |
| GET | `/api/tags/events` | Tags used on events |
| GET | `/api/tags/persons` | Tags used on persons |
| GET | `/api/tags/manage` | Management list (all org tags incl. unused, with counts) |
| GET | `/api/tags/duplicates` | Likely-duplicate tag pairs |
| GET | `/api/tags/followed` | Tags the current user follows |
| PUT | `/api/tags/followed/{tagId}` | Follow a tag |
| DELETE | `/api/tags/followed/{tagId}` | Unfollow a tag |
| GET | `/api/tags/{id}/impact` | Org-wide impact preview for delete/merge dialogs |
| PATCH | `/api/tags/{id}` | Update a tag description and/or name (owner-only rename) |
| DELETE | `/api/tags/{id}` | Delete a tag |
| POST | `/api/tags/merge` | Merge one tag into another |
| GET | `/api/tags/keep-separate` | List pairs marked "keep separate" |
| POST | `/api/tags/keep-separate` | Mark a pair as not duplicates |
| DELETE | `/api/tags/keep-separate` | Restore a dismissed pair |
| GET | `/api/organization/members` | List members |
| PATCH | `/api/organization/members/{userId}` | Change a member's role (owner only) |
| DELETE | `/api/organization/members/{userId}` | Remove a member (owner only) |
| GET | `/api/organization/invitations` | List invitations (owner only) |
| POST | `/api/organization/invitations` | Create an invitation (owner only) |
| DELETE | `/api/organization/invitations/{invitationId}` | Cancel an invitation (owner only) |
| GET | `/api/organization/invitations/token/{token}` | Public invitation details by token |
| POST | `/api/organization/invitations/token/{token}/accept` | Accept an invitation |
| POST | `/api/organization/leave` | Leave the organization |
| DELETE | `/api/organization` | Delete the organization (owner only) |
| GET | `/api/organization/export` | Export all organization data |
| GET | `/api/organization/info` | Read organization info |
| PATCH | `/api/organization/info` | Update organization info |

…and 47 more operations. They are listed in full on the page.

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/historis-app/openapi/_original/historis-app-api-openapi.json
- **JSONSchema** — https://artifacts.apis.io/historis-app/json-schema/historis-app-knowledge-saved-view-input-schema.json
- **JSONSchema** — https://artifacts.apis.io/historis-app/json-schema/historis-app-event-input-schema.json
- **JSONSchema** — https://artifacts.apis.io/historis-app/json-schema/historis-app-webhook-ingest-schema.json
- **JSONSchema** — https://artifacts.apis.io/historis-app/json-schema/historis-app-person-input-schema.json
- **JSONSchema** — https://artifacts.apis.io/historis-app/json-schema/historis-app-rule-input-schema.json
- **JSONSchema** — https://artifacts.apis.io/historis-app/json-schema/historis-app-credentials-schema.json

## Other Historis APIs (1)

- [Historis API](https://apis.io/apis/historis-app/historis-api/)

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/historis-app/historis-api-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/historis-app/.