Skip to main content
GET
/
contexts
List conversation contexts
curl --request GET \
  --url https://apigcp.trynia.ai/v2/contexts \
  --header 'Authorization: Bearer <token>'
{
  "contexts": [
    {
      "id": "<string>",
      "user_id": "<string>",
      "organization_id": "<string>",
      "title": "<string>",
      "summary": "<string>",
      "content": "<string>",
      "tags": [
        "<string>"
      ],
      "agent_source": "<string>",
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z",
      "metadata": {},
      "nia_references": {
        "indexed_repositories": [
          "<string>"
        ],
        "indexed_documentation": [
          "<string>"
        ],
        "queried_repositories": [
          "<string>"
        ],
        "queried_documentation": [
          "<string>"
        ],
        "web_searches": [
          "<string>"
        ],
        "deep_research_queries": [
          "<string>"
        ]
      },
      "edited_files": [
        {
          "file_path": "<string>",
          "operation": "created",
          "lines_added": 123,
          "lines_removed": 123,
          "language": "<string>"
        }
      ],
      "memory_type": "scratchpad",
      "expires_at": "2023-11-07T05:31:56Z",
      "lineage": {
        "created_at": "2023-11-07T05:31:56Z",
        "source_ids": [
          "<string>"
        ],
        "confidence": 0.5,
        "derived_from": [
          "<string>"
        ],
        "tool_calls": [
          "<string>"
        ],
        "model_version": "<string>"
      }
    }
  ],
  "pagination": {
    "total": 123,
    "limit": 123,
    "offset": 123,
    "has_more": true
  }
}

Authorizations

​
Authorization
string
header
required

API key must be provided in the Authorization header

Query Parameters

​
limit
integer
default:20

Number of contexts to return

Required range: 1 <= x <= 100
​
offset
integer
default:0

Number of contexts to skip (for pagination)

Required range: x >= 0
​
tags
string

Comma-separated tags to filter by

​
agent_source
string

Filter by agent source (e.g., "cursor", "claude-code")

​
memory_type
enum<string>

Filter by memory type (scratchpad, episodic, fact, procedural) Memory taxonomy type:

  • scratchpad: Temporary working memory (1hr TTL)
  • episodic: Session summaries (7d TTL)
  • fact: Atomic factual statements (permanent)
  • procedural: Tool/function definitions (permanent)
Available options:
scratchpad,
episodic,
fact,
procedural

Response

Contexts retrieved successfully

​
contexts
object[]
​
pagination
object