# HalfPage API

> Programmatic Cellpose cell segmentation for microscopy images — upload, predict, and export ROIs and measurements.

## Docs

- [Using with AI agents](https://docs.halfpagetechnologies.com/ai-agents.md): Drive the HalfPage API from an AI agent using the OpenAPI spec, llms.txt, and the hosted MCP server.
- [Export measurements (CSV)](https://docs.halfpagetechnologies.com/api-reference/export/export-measurements-csv.md): Download per-cell measurements for a completed segmentation as CSV — one row per detected ROI, with morphometric columns. Returned as a file attachment.
- [Export ROIs (GeoJSON)](https://docs.halfpagetechnologies.com/api-reference/export/export-rois-geojson.md): Download a segmentation's ROIs as a GeoJSON FeatureCollection, one polygon feature per cell in image pixel coordinates. Returned as a file attachment.
- [Export ROIs (ImageJ ZIP)](https://docs.halfpagetechnologies.com/api-reference/export/export-rois-imagej-zip.md): Download a segmentation's ROIs as a ZIP of ImageJ-compatible `.roi` files, ready to open in Fiji/ImageJ's ROI Manager. Returned as a file attachment.
- [List available models](https://docs.halfpagetechnologies.com/api-reference/models/list-available-models.md): List the segmentation models available to your organization.
- [Get prediction status](https://docs.halfpagetechnologies.com/api-reference/predict/get-prediction-status.md): Poll a prediction until it finishes.
- [Run a prediction](https://docs.halfpagetechnologies.com/api-reference/predict/run-a-prediction.md): Start an asynchronous segmentation of a ready image.
- [Delete an image](https://docs.halfpagetechnologies.com/api-reference/upload/delete-an-image.md): Permanently delete an image and all of its derived storage (converted TIFF/PNG, thumbnail, and any training artifacts), freeing its slot against your storage cap. Any resumable upload still in flight is aborted first, so its uploaded chunks are released too. Scoped to your organization — an image ou…
- [Finish a resumable upload](https://docs.halfpagetechnologies.com/api-reference/upload/finish-a-resumable-upload.md): Assemble a resumable upload from its uploaded parts, mark the image `processing`, and kick off async conversion. Returns `202` — conversion runs off the request path, so poll `GET /upload/{image_id}` until `ready`.
- [Get upload status](https://docs.halfpagetechnologies.com/api-reference/upload/get-upload-status.md): Fetch an image's upload lifecycle and metadata.
- [Upload an image](https://docs.halfpagetechnologies.com/api-reference/upload/upload-an-image.md): Get a microscopy image into HalfPage. How the request is sent decides which of the two modes you get:
- [Authentication](https://docs.halfpagetechnologies.com/authentication.md): Create an API key in the dashboard and authenticate requests with a bearer token.
- [HalfPage API](https://docs.halfpagetechnologies.com/introduction.md): Run Cellpose cell segmentation on your microscopy images programmatically — upload an image, run a prediction, and export ROIs and measurements.
- [Quickstart](https://docs.halfpagetechnologies.com/quickstart.md): Upload a microscopy image, run a segmentation, and download the ROIs — end to end.

## OpenAPI Specs

- [openapi](https://docs.halfpagetechnologies.com/api-reference/openapi.json)