---
title: "API"
url: https://tacticsjournal.com/docs/api/
---

# Tactics Journal API

Tactics Journal exposes a small set of public HTTP endpoints for subscription and account flows.

## Base URL

`https://tacticsjournal.com`

## Discovery

* API catalog: `/.well-known/api-catalog`
* OpenAPI description: `/openapi.json`
* Health: `/api/health`
* Agent skills index: `/.well-known/agent-skills/index.json`
* MCP server card: `/.well-known/mcp/server-card.json`

## Public endpoints

### `GET /api/health`

Returns a simple health payload.

### `POST /api/subscribe`

Subscribes an email address to Tactics Journal updates.

Accepted content types:

* `application/json`
* `application/x-www-form-urlencoded`
* `multipart/form-data`

Example JSON body:

    {
      "email": "reader@example.com",
      "tag": ["opinion", "research"]
    }

### `POST /api/account/start`

Starts the passwordless account sign-in flow by emailing a magic link.

Example JSON body:

    {
      "email": "reader@example.com",
      "next": "/research/"
    }

### `GET /account/finish?token=...&next=...`

Consumes a magic-link token, sets the session cookie, and redirects.

### `GET /api/account/session`

Returns the current cookie-backed session state.

### `POST /api/account/signout`

Clears the current session cookie.

## Authentication model

The site currently uses cookie-based passwordless sessions for browser account access. It does not yet expose a standards-compliant OAuth 2.0 or OpenID Connect authorization server.

## Markdown for agents

HTML pages support content negotiation. Send:

    Accept: text/markdown

to receive a markdown representation with:

* `Content-Type: text/markdown`
* `x-markdown-tokens` token estimate header

---

Web page: https://tacticsjournal.com/docs/api/
Every post and page as Markdown: https://tacticsjournal.com/llms.txt
