Skip to main content
POST
Save context

Authorizations

Authorization
string
header
required

API key must be provided in the Authorization header

Body

application/json

Request model for creating a shared context.

title
string
required
Required string length: 1 - 200
summary
string
required
Required string length: 10 - 1000
content
string
required
Minimum string length: 50
agent_source
string
required

Which agent created this context

tags
string[]
metadata
Metadata · object
organization_id
string | null
nia_references
NiaReferences · object | null

Structured tracking of NIA resources used during conversation.

edited_files
EditedFile · object[]
memory_type
enum<string>
default:episodic

Memory type: scratchpad (1hr), episodic (7d), fact (permanent), procedural (permanent)

Available options:
scratchpad,
episodic,
fact,
procedural
ttl_seconds
integer | null

Custom TTL in seconds. If not set, uses memory_type default.

Required range: x >= 0
lineage
LineageInput · object | null

Provenance tracking for this context

Response

Successful Response

Response model for context operations.

id
string
required
user_id
string
required
title
string
required
summary
string
required
content
string
required
tags
string[]
required
agent_source
string
required
created_at
string<date-time>
required
metadata
Metadata · object
required
organization_id
string | null
updated_at
string<date-time> | null
nia_references
NiaReferences · object | null

Structured tracking of NIA resources used during conversation.

edited_files
EditedFile · object[]
memory_type
enum<string>
default:episodic
Available options:
scratchpad,
episodic,
fact,
procedural
expires_at
string<date-time> | null
lineage
LineageMetadata · object | null

Provenance tracking for content artifacts.

category_id
string | null