Schemas

All models are Pydantic BaseModel subclasses. Import from sectra_client.schemas:

from sectra_client.schemas import Point, Polygon, Result, ...

---

Common

Model	Fields	Notes
Point	x: float, y: float	Normalized coordinates (0–1)
Polygon	points: list[Point]	Closed shape
Polyline	points: list[Point]	Open path
Size	width: int, height: int	Pixel dimensions
CallbackInfo	url: str, token: str	Sectra callback credentials, from the invocation
ApplicationInfo	apiVersion: str, softwareVersion: str	Reported by the server

---

Image

ImageMetadata

Full slide metadata: pixel size, tile format, focal planes, optical paths, staining, and more. Returned by SectraClient.get_image_metadata().

CaseImageInfo

Lightweight summary of a slide within a case. Returned by get_image_infos_in_case*().

LabelImage

label: LabelImage = client.get_label_image(slide_id)
pil_image = label.convert_to_pil()

---

Invocation

Sectra POSTs an Invocation to your webhook. It is a discriminated union on the action field.

from sectra_client.schemas.invocation import Invocation

@app.post("/sectra/hook")
def hook(invocation: Invocation):
    match invocation:
        case CreateInvocation():   ...
        case ModifyInvocation():   ...
        case CancelInvocation():   ...
        case DeleteInvocation():   ...

Type	action	Key extra fields
CreateInvocation	CREATE	input: CreateInput
ModifyInvocation	MODIFY	input: ResultResponse (existing result to update)
CancelInvocation	CANCEL	—
DeleteInvocation	DELETE	—

All invocations share: applicationId, slideId, callbackInfo.

CreateInput

Another discriminated union on inputType:

Type	inputType	Extra fields
WholeSlideInput	WHOLE_SLIDE	—
TaggedPolygonInput	TAGGED_POLYGON	polygons, tag
MultiAreaInput	MULTI_AREA	areas

---

Results

Building a result

Result(
    slideId=...,
    displayResult="Human-readable label",
    displayProperties=DisplayProperties({"Key": "Value"}),
    applicationVersion="1.0.0",
    data=ResultData(result=<PrimitiveResultContent or PatchResultContent>),
)

PrimitiveResultContent

A list of drawable items (polygons, polylines, labels).

PrimitiveResultContent(
    content=[
        PrimitiveItem(
            polygons=[Polygon(points=[...])],
            style=Style(strokeStyle="#FF0000", size=2, fillStyle="#FF000033"),
        )
    ]
)

Model	Key fields
PrimitiveItem	polygons, polylines, labels, style
Style	strokeStyle: str (CSS color), fillStyle: str, size: int
Label	text: str, position: Point

PatchResultContent

A grid of classified patches over the slide.

PatchResultContent(
    content=PatchContent(
        patches=[Patch(tag=2, position=Point(x=0.5, y=0.5), sortKeyValue=0.9)],
        tags=["Negative", "Uncertain", "Positive"],
        patchSize=128,
        magnification=2.0,
        ...
    )
)

Model	Key fields
PatchContent	patches, tags, polygons, actions, patchSize, magnification, statuses
Patch	tag: int, position: Point, sortKeyValue: float
Action	id, name, tooltip, state
Status	value: bool, message: str

ResultResponse

Returned by create_results() and get_*results*(). Extends Result with:

Field	Type	Description
id	int	Assigned result ID
versionId	str	Required for updates (optimistic concurrency)

AdaptedResult

Used with update_results(). Same fields as Result, plus versionId: str.

---

Quality control

from sectra_client.schemas import QualityControl, QualityControlData, QualityControlStatus

client.set_quality_control(
    slide_id,
    QualityControl(
        applicationVersion="1.0.0",
        qualityControl=QualityControlData(
            status=QualityControlStatus.QUALITY_OK,
            versionId=current_version_id,
        ),
    ),
)

QualityControlStatus	Value
NOT_SET	Default, no decision
QUALITY_OK	Slide accepted
REJECTED	Slide rejected