Subjects

Issue a passwordless, single-use magic-link token for the end-user memory portal (T424)

Tenant-authenticated -- the caller is the tenant's own backend, which knows the subjectId and is responsible for delivering the link to the end user (ContextQ has no notion of a subject's email address and sends no mail itself). The returned token is shown exactly once, single-use, and expires in 15 minutes; the caller embeds it into whatever URL/UI convention it wants pointing at its own frontend, which then exchanges it via the separate, unauthenticated POST /api/subject-portal/verify for a short-lived portal session. Always succeeds for a well-formed subjectId, whether or not that subject has any memories yet. See docs/arch/subject-memory-portal-api.md for the full contract. Rate limited to 5 requests / 10 minutes per (tenant, subjectId).

post/api/subjects/{subjectId}/magic-link

Request

  • Base URL: http://localhost:38200
  • URL: http://localhost:38200/api/subjects/{subjectId}/magic-link
  • Auth: one of:
    • HTTP bearer
    • API key in cookie token

Path parameters

subjectIdstring required

Response

Magic-link token issued.

subject_idstring
tokenstring

Raw token, shown exactly once. Never persisted or re-derivable from the stored hash.

expires_atstring date-time

Changes

No recorded changes to this operation across all 1 revision of this API.