⚙️Jtheta API documentation

📘 JTheta.ai REST API Documentation

Welcome to the JTheta.ai API — your gateway to building end-to-end workflows for dataset creation, annotation task management, and AI-assisted labeling.

You need a API key to use REST API.Refer to the following documentation on how to create API key:

🔑 Create JTheta API Key

Base URL:

https://api.jtheta.ai

---

🚀 Quickstart: Validating Your API Key

✅ GET /validate_key/

Use this endpoint to test if your API key is valid.

Curl Example:

curl -X GET https://api.jtheta.ai/validate_key/ \
  -H "Authorization: Bearer <your_api_key>"

Responses:

• 200 OK: Valid API key

• 401 Unauthorized: Missing or invalid key

---

📁 Projects & Datasets

🆕 POST /create_project/

Create a new project to group datasets and tasks.

Required JSON body:

{
  "project_title": "Retinal Dataset",
  "project_category": "Medical Imaging"
}

Responses:

• 201 Created: Project created

• 400 Bad Request: Missing or invalid fields

• 401 Unauthorized: Invalid API key

---

📦 POST /create_dataset/

Upload images into a new dataset under an existing project.

Required fields (multipart/form-data):

• dataset_name: name of the dataset

• project_name: project to associate

• license: optional license info

• images: multiple image files

Curl Example:

curl -X POST https://api.jtheta.ai/create_dataset/ \
  -F dataset_name=TumorSlides \
  -F project_name=RetinalResearch \
  -F images=@slide1.png \
  -F images=@slide2.png

Response:

• 201 Created: Dataset and images uploaded

---

📥 POST /upload_images_to_dataset/

Add more images to an existing dataset.

Required fields (multipart/form-data):

• dataset_id: numeric ID

• project_name

• images: additional image files

---

👩‍🏫 Annotation Workflow

✍️ POST /request_annotation/

Assign annotators and reviewers to a dataset and define label types.

Required JSON:

{
  "dataset_id": 1,
  "project_name": "Tumor Study",
  "assigned_annotator": "[e-mail]",
  "assigned_reviewer": "[e-mail]",
  "labels": [
    { "label": "Tumor", "type": "polygon" },
    { "label": "Blood Vessel", "type": "bounding_box" }
  ]
}

Response:

• 200 OK: Task assigned

---

📊 GET /get_annotation_status/{project_title}/

Check the progress of annotation for a given project.

Path parameter:

• project_title: name of the project

---

🗑️ POST /delete_project/

Delete a project and all associated datasets, images, and annotations.

JSON Body:

{
  "project_title": "Old Medical Study"
}

---

📤 Export and Download

📥 GET /api/export/download

Get the dataset’s metadata and download URL.

Query parameter:

• key: your API access key

Example:

curl "https://api.jtheta.ai/api/export/download?key=<your_api_key>"

Response:

• 302 Found: Redirects to download URL