Update context

Update an existing context. Re-indexes in vector store if content changes.

PUT /contexts/{context_id}

Update context

cURL

curl --request PUT \
  --url https://apigcp.trynia.ai/v2/contexts/{context_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "title": "<string>",
  "summary": "<string>",
  "content": "<string>",
  "tags": [
    "<string>"
  ],
  "metadata": {},
  "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>"
    }
  ],
  "organization_id": "<string>",
  "ttl_seconds": 1,
  "lineage": {
    "source_ids": [
      "<string>"
    ],
    "confidence": 0.5,
    "derived_from": [
      "<string>"
    ],
    "tool_calls": [
      "<string>"
    ],
    "model_version": "<string>"
  }
}
'

200

{
  "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>"
}

Authorizations

Authorization · string · header · required

API key must be provided in the Authorization header

Path Parameters

context_id · string · required

Body

application/json

Request model for updating a shared context.

title · string | null

Required string length: 1 - 200

summary · string | null

Required string length: 10 - 1000

content · string | null

Minimum string length: 50

tags · string[] | null

metadata · Metadata · object | null

nia_references · NiaReferences · object | null

Structured tracking of NIA resources used during conversation.

Show child attributes

edited_files · EditedFile · object[] | null

Show child attributes

organization_id · string | null

memory_type · enum<string> | null

Memory type

Available options: scratchpad, episodic, fact, procedural

ttl_seconds · integer | null

Custom TTL in seconds

Required range: x >= 0

lineage · LineageInput · object | null

Provenance tracking

Show child attributes

Response

200

application/json

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.

Show child attributes

edited_files · EditedFile · object[]

Show child attributes

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.

Show child attributes

category_id · string | null