Skip to main content
POST
/
contexts
Save context
curl --request POST \
  --url https://apigcp.trynia.ai/v2/contexts \
  --header 'Content-Type: application/json' \
  --data '
{
  "title": "<string>",
  "summary": "<string>",
  "content": "<string>",
  "agent_source": "<string>",
  "tags": [
    "<string>"
  ],
  "metadata": {},
  "organization_id": "<string>",
  "nia_references": {
    "indexed_resources": [
      {
        "identifier": "<string>",
        "resource_type": "<string>",
        "purpose": "<string>",
        "indexed_at": "<string>"
      }
    ],
    "search_queries": [
      {
        "query": "<string>",
        "query_type": "<string>",
        "key_findings": "<string>",
        "resources_searched": [
          "<string>"
        ],
        "useful_results_count": 0
      }
    ],
    "session_summary": "<string>"
  },
  "edited_files": [
    {
      "file_path": "<string>",
      "operation": "<string>",
      "changes_description": "<string>",
      "key_changes": [
        "<string>"
      ],
      "language": "<string>"
    }
  ],
  "memory_type": "episodic",
  "ttl_seconds": 1,
  "lineage": {
    "source_ids": [
      "<string>"
    ],
    "confidence": 0.5,
    "derived_from": [
      "<string>"
    ],
    "tool_calls": [
      "<string>"
    ],
    "model_version": "<string>"
  }
}
'
{
  "id": "<string>",
  "user_id": "<string>",
  "title": "<string>",
  "summary": "<string>",
  "content": "<string>",
  "tags": [
    "<string>"
  ],
  "agent_source": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "metadata": {},
  "organization_id": "<string>",
  "updated_at": "2023-11-07T05:31:56Z",
  "nia_references": {
    "indexed_resources": [
      {
        "identifier": "<string>",
        "resource_type": "<string>",
        "purpose": "<string>",
        "indexed_at": "<string>"
      }
    ],
    "search_queries": [
      {
        "query": "<string>",
        "query_type": "<string>",
        "key_findings": "<string>",
        "resources_searched": [
          "<string>"
        ],
        "useful_results_count": 0
      }
    ],
    "session_summary": "<string>"
  },
  "edited_files": [
    {
      "file_path": "<string>",
      "operation": "<string>",
      "changes_description": "<string>",
      "key_changes": [
        "<string>"
      ],
      "language": "<string>"
    }
  ],
  "memory_type": "episodic",
  "expires_at": "2023-11-07T05:31:56Z",
  "lineage": {
    "created_at": "2023-11-07T05:31:56Z",
    "source_ids": [
      "<string>"
    ],
    "confidence": 123,
    "derived_from": [
      "<string>"
    ],
    "tool_calls": [
      "<string>"
    ],
    "model_version": "<string>"
  },
  "category_id": "<string>"
}

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

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

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

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

Provenance tracking for content artifacts.

category_id
string | null