Write Session Relationship Context

PATCH

/v1/sessions/:session_id/relationship-context

Append developer-owned relationship context for one session.

This is a typed writeback layer for product facts such as “founding friend” or “inner circle”. It is deliberately NOT canon/persona mutation: the data is stored as a session context event, bounded by TTL, and then consumed through the same speakable/private/forbidden lanes as POST /context-events.

Authentication

AuthorizationBearer

LoreOS API key, sent as Authorization: Bearer <key>.

Path parameters

session_idstringRequired

Request

This endpoint expects an object.

relationship_labelstring or nullOptional<=120 characters

Optional app-side label such as founding_friend or inner_circle.

speakable_relationship_factslist of stringsOptional

Relationship facts the character may say if relevant.

private_relationship_contextlist of stringsOptional

Planning-only relationship context; never spoken directly.

forbidden_to_reveallist of stringsOptional

Hard constraints the reply must not reveal or imply.

memory_candidateslist of stringsOptional

Optional relationship memories to propose to the memory pipeline.

ttl_secondsinteger or nullOptional1-86400

How long this context should shape replies. Default is about 10 minutes.

prioritydoubleOptional0-1Defaults to 0.6

Ranking when multiple context events are active.

idempotency_keystring or nullOptional<=256 characters

Response

Successful Response

Errors

422

Unprocessable Entity Error

$	curl -X PATCH https://api.loreos.app/v1/sessions/session_id/relationship-context \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{}'