🔃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

or

get

/api/session

HTTPcURLJavaScriptPython

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

200

Successful Response

[
  {
    "created_at": "2026-02-18T21:58:43.207Z",
    "modified_at": "2026-02-18T21:58:43.207Z",
    "id": 1,
    "stack_id": 1,
    "meta_data": {}
  }
]

Create Session

post

Responses

200

Successful Response

application/json

Stack Session Response Data Model.

Args: id : int stack_id : int meta_data : dict created_at : datetime modified_at : datetime

created_atstring · date-timeRequired

modified_atstring · date-timeOptional

idintegerRequired

stack_idintegerRequired

meta_dataobject · MetaDataRequired

post

/api/session

HTTPcURLJavaScriptPython

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

200

Successful Response

{
  "created_at": "2026-02-18T21:58:43.207Z",
  "modified_at": "2026-02-18T21:58:43.207Z",
  "id": 1,
  "stack_id": 1,
  "meta_data": {}
}

Get Session

get

Path parameters

session_idintegerRequired

Responses

200

Successful Response

application/json

Stack Session Response Data Model.

Args: id : int stack_id : int meta_data : dict created_at : datetime modified_at : datetime

created_atstring · date-timeRequired

modified_atstring · date-timeOptional

idintegerRequired

stack_idintegerRequired

meta_dataobject · MetaDataRequired

422

Validation Error

application/json

get

/api/session/{session_id}

HTTPcURLJavaScriptPython

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

{
  "created_at": "2026-02-18T21:58:43.207Z",
  "modified_at": "2026-02-18T21:58:43.207Z",
  "id": 1,
  "stack_id": 1,
  "meta_data": {}
}

Delete Session

delete

Path parameters

session_idintegerRequired

Responses

200

Successful Response

application/json

object · ResponseDeleteSessionApiSessionSessionIdDeleteOptional

422

Validation Error

application/json

delete

/api/session/{session_id}

HTTPcURLJavaScriptPython

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

{}

ETL

Extract

post

Query parameters

session_idintegerOptional

Responses

200

Successful Response

application/json

idintegerRequired

session_idintegerRequired

statusundefined · enumRequired

An enumeration.

Possible values:

metadataobject · MetadataOptional

422

Validation Error

application/json

post

/api/etl/submit-job

HTTPcURLJavaScriptPython

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

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

Model

Predict

post

Body

application/json

promptstringRequired

Responses

200

Successful Response

application/json

outputstringRequired

422

Validation Error

application/json

post

/api/model/predict

HTTPcURLJavaScriptPython

POST /api/model/predict HTTP/1.1
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

session_idintegerRequired

outputstringRequired

422

Validation Error

application/json

get

/api/retriever/retrieve

HTTPcURLJavaScriptPython

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

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

Vectordb

Add Documents

post

Body

application/json

session_idintegerRequired

Responses

200

Successful Response

application/json

session_idintegerRequired

422

Validation Error

application/json

post

/api/vectordb/add-documents

HTTPcURLJavaScriptPython

POST /api/vectordb/add-documents HTTP/1.1
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

session_idintegerRequired

422

Validation Error

application/json

get

/api/vectordb/search

HTTPcURLJavaScriptPython

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

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

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