🔃GenAI Server API's Reference

Here are the API's for the core components of GenAI Stack Server.

Session

Sessions List

get

Responses

200

Successful Response

application/json

Responseany of

or

get

/api/session

HTTPcURLJavaScriptPython

GET /api/session HTTP/1.1
Host: 
Accept: */*

200

Successful Response

[
  {
    "created_at": "2025-11-21T17:44:49.862Z",
    "modified_at": "2025-11-21T17:44:49.862Z",
    "id": 1,
    "stack_id": 1,
    "meta_data": {}
  }
]

Create Session

post

Responses

200

Successful Response

application/json

post

/api/session

HTTPcURLJavaScriptPython

POST /api/session HTTP/1.1
Host: 
Accept: */*

200

Successful Response

{
  "created_at": "2025-11-21T17:44:49.862Z",
  "modified_at": "2025-11-21T17:44:49.862Z",
  "id": 1,
  "stack_id": 1,
  "meta_data": {}
}

Get Session

get

Path parameters

session_idintegerRequired

Responses

200

Successful Response

application/json

422

Validation Error

application/json

get

/api/session/{session_id}

HTTPcURLJavaScriptPython

GET /api/session/{session_id} HTTP/1.1
Host: 
Accept: */*

{
  "created_at": "2025-11-21T17:44:49.862Z",
  "modified_at": "2025-11-21T17:44:49.862Z",
  "id": 1,
  "stack_id": 1,
  "meta_data": {}
}

Delete Session

delete

Path parameters

session_idintegerRequired

Responses

200

Successful Response

application/json

Responseobject · ResponseDeleteSessionApiSessionSessionIdDelete

422

Validation Error

application/json

delete

/api/session/{session_id}

HTTPcURLJavaScriptPython

DELETE /api/session/{session_id} HTTP/1.1
Host: 
Accept: */*

{}

ETL

Extract

post

Query parameters

session_idintegerOptional

Responses

200

Successful Response

application/json

422

Validation Error

application/json

post

/api/etl/submit-job

HTTPcURLJavaScriptPython

POST /api/etl/submit-job HTTP/1.1
Host: 
Accept: */*

{
  "id": 1,
  "session_id": 1,
  "status": "pending",
  "metadata": {}
}

Model

Predict

post

Body

application/json

promptstringRequired

Responses

200

Successful Response

application/json

422

Validation Error

application/json

post

/api/model/predict

HTTPcURLJavaScriptPython

POST /api/model/predict HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 17

{
  "prompt": "text"
}

{
  "output": "text"
}

Retriever

Retrieve

get

Query parameters

session_idintegerRequired

querystringRequired

Responses

200

Successful Response

application/json

422

Validation Error

application/json

get

/api/retriever/retrieve

HTTPcURLJavaScriptPython

GET /api/retriever/retrieve?session_id=1&query=text HTTP/1.1
Host: 
Accept: */*

{
  "session_id": 1,
  "output": "text"
}

Vectordb

Add Documents

post

Body

application/json

session_idintegerRequired

Responses

200

Successful Response

application/json

422

Validation Error

application/json

post

/api/vectordb/add-documents

HTTPcURLJavaScriptPython

POST /api/vectordb/add-documents HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 68

{
  "session_id": 1,
  "documents": [
    {
      "page_content": "text",
      "metadata": {}
    }
  ]
}

{
  "session_id": 1,
  "documents": [
    {
      "page_content": "text",
      "metadata": {}
    }
  ]
}

Search

get

Body

application/json

session_idintegerRequired

querystringRequired

Responses

200

Successful Response

application/json

422

Validation Error

application/json

get

/api/vectordb/search

HTTPcURLJavaScriptPython

GET /api/vectordb/search HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 31

{
  "session_id": 1,
  "query": "text"
}

{
  "session_id": 1,
  "documents": [
    {
      "page_content": "text",
      "metadata": {}
    }
  ]
}