Get Session Detail - Cognee Documentation

GET

/

api

/

v1

/

sessions

/

{session_id}

Get Session Detail

curl --request GET \
  --url https://api.cognee.ai/api/v1/sessions/{session_id} \
  --header 'Authorization: Bearer <token>'

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

session_id

string

required

Response

Successful Response

RememberIngest data and build the knowledge graph in a single call. This endpoint combines the add and cognify steps. Data is ingested first, then automatically processed into a structured knowledge graph. ## Request Parameters - **data** (List[UploadFile]): Files to upload and process. - **datasetName** (Optional[str]): Name of the target dataset. - **datasetId** (Optional[UUID]): UUID of an existing dataset. - **node_set** (Optional[List[str]]): Node identifiers for graph organisation. - **run_in_background** (Optional[bool]): Run the cognify step asynchronously (default: False). - **custom_prompt** (Optional[str]): Custom prompt for entity extraction. - **chunk_size** (Optional[int]): Maximum tokens per chunk. Defaults to automatic model-based sizing. - **chunks_per_batch** (Optional[int]): Chunks per cognify batch. - **ontology_key** (Optional[List[str]]): Reference to one or more previously uploaded ontology files to use for knowledge graph construction. - **graph_model** (Optional[str]): JSON-serialised graph model schema (same dict format accepted by the cognify endpoint). Either datasetName or datasetId must be provided. ## Error Codes - **400 Bad Request**: Neither datasetId nor datasetName provided - **409 Conflict**: Error during processing

⌘I

Get Session Detail

curl --request GET \
  --url https://api.cognee.ai/api/v1/sessions/{session_id} \
  --header 'Authorization: Bearer <token>'

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}