Endpoint

Method

Description

Required Scopes

Status Codes

/v1/datastores

POST

Create a new datastore and ingest client data

ingest

201, 400, 409

/v1/datastores/{id}

GET

Retrieve metadata and current status for a datastore

ingest

200, 401, 404

/v1/datastores/{id}

DELETE

Delete a datastore and all associated models and data

admin

204, 401, 404

/v1/datastores/{id}/train

POST

Initiate fine‑tuning of the Leora base model on your data

train

202, 400, 404

/v1/datastores/{id}/train/{job}/status

GET

Poll status, progress, and evaluation metrics of a training job

train

200, 401, 404

/v1/datastores/{id}/recommendations/user

GET

Retrieve top‑K personalized recommendations for a known user

infer

200, 400, 401

/v1/datastores/{id}/recommendations/session

GET

Retrieve top‑K recommendations based on a session activity

infer

200, 400, 401