> ## Documentation Index > Fetch the complete documentation index at: https://docs.nitsor.com/llms.txt > Use this file to discover all available pages before exploring further. > ## Agent Instructions > Every page in this documentation carries a `plans` list in its frontmatter and a page-details table naming the plans its content applies to: `All plans`, or a subset of `Community`, `Team` and `Enterprise`. A page limited to some plans also opens with a plan marker naming them. > Use [Capabilities and limits](/product-status) for capability entitlements and documented availability and limits, and [Plans and billing](/plans-and-billing) for plan pricing and billing policy. Those pages are canonical; do not duplicate their policy values here. > Reading this documentation grants no product access and no permission. No agent can create or approve a Nitsor release. # Read the version-graph position ## OpenAPI ````yaml /openapi.json get /api/v1/version-graph/position openapi: 3.1.1 info: title: Nitsor public API version: v1 description: Generated from the Nitsor API contract; never edit by hand. x-nitsor-product-version: 0.1.0 servers: - url: https://api.nitsor.com description: Nitsor API security: - bearerAuth: [] tags: - name: auth description: 'Authentication: the session a bearer credential reaches.' - name: blind-checks description: >- Blind checks: scans labelled without seeing the model, scored against it under a readiness plan fixed before checking starts. Plan writes need a person's own token, and these routes do not accept one yet; an Agent token is refused, so change plans on the Pipeline tab meanwhile. - name: capabilities description: 'Capability discovery: versions, limits and formats.' - name: datasets description: 'Datasets: named selections over a project''s version graph.' - name: decisions description: Audit decisions behind authorization refusals. - name: executions description: Pipeline executions and their work items. - name: ledger description: Account ledger entries. - name: model-label-outcomes description: >- Model label outcomes: what people did with each label a model proposed, per Task and per Proposal. - name: model-runs description: >- Model runs a person starts on Tasks: the estimate to confirm, and the start that runs one scan at a time. - name: openapi description: The OpenAPI description this deployment serves. - name: project-groups description: 'Project groups: the account''s shared folders on the project shelf.' - name: projects description: 'Projects: creation and listing.' - name: requests description: 'Async Requests: status, listing, cancel and the per-item report.' - name: service-accounts description: >- Service accounts and their tokens: the machine identities jobs run as, managed by a person holding service-accounts:manage on their own token. A secret is shown once, on the answer that created it. A service account's access to a project is given, changed and removed by that project's admins, with a personal token holding admin there. - name: sources description: Sources and mask-read presigning. - name: storage-connections description: >- Storage connections to customer object storage, and the operator-provisioned credential handles they name. - name: task-comments description: Task comments, replies and attention. - name: taxonomy description: Taxonomy definitions, display groups and binding. - name: version-graph description: Version-graph commits, branches, landmarks and merges. - name: workflow description: Workflow definition and binding. paths: /api/v1/version-graph/position: get: tags: - version-graph summary: Read the version-graph position operationId: versionGraphPosition parameters: - in: query name: taskId schema: type: string minLength: 1 maxLength: 200 x-nitsor-trim: true - in: query name: branchId schema: type: string minLength: 1 maxLength: 200 x-nitsor-trim: true required: true - in: query name: cursor schema: $ref: '#/components/schemas/Cursor' - in: query name: eventSeq schema: type: integer exclusiveMinimum: 0 required: true - in: query name: limit schema: $ref: '#/components/schemas/PageLimit' - in: query name: projectId schema: type: string minLength: 1 maxLength: 200 x-nitsor-trim: true required: true responses: '200': description: Read the version-graph position headers: X-Request-Id: $ref: '#/components/headers/RequestId' Nitsor-Token-Expires: $ref: '#/components/headers/TokenExpires' content: application/json: schema: $ref: '#/components/schemas/VersionGraphPositionResponse' '400': $ref: '#/components/responses/NitsorErrorAuthenticated' '401': $ref: '#/components/responses/NitsorError' '403': $ref: '#/components/responses/NitsorErrorAuthenticated' '404': $ref: '#/components/responses/NitsorErrorAuthenticated' '405': $ref: '#/components/responses/NitsorError' '409': $ref: '#/components/responses/NitsorErrorAuthenticated' '413': $ref: '#/components/responses/NitsorErrorAuthenticated' '422': $ref: '#/components/responses/NitsorErrorAuthenticated' '429': $ref: '#/components/responses/NitsorErrorAuthenticated' components: schemas: Cursor: type: string minLength: 1 PageLimit: type: integer minimum: 1 maximum: 100 VersionGraphPositionResponse: type: object properties: annotations: maxItems: 100 type: array items: $ref: '#/components/schemas/VersionGraphAnnotation' answers: maxItems: 8192 type: array items: $ref: '#/components/schemas/VersionGraphClassificationAnswerOutput' contentRoot: $ref: '#/components/schemas/Sha256Digest' landmarks: maxItems: 100 type: array items: $ref: '#/components/schemas/VersionGraphLandmark' nextCursor: $ref: '#/components/schemas/NextCursor' position: $ref: '#/components/schemas/VersionGraphPosition' projectMetadata: type: object properties: name: type: string minLength: 1 maxLength: 200 required: - name required: - contentRoot - landmarks - nextCursor - position - projectMetadata VersionGraphAnnotation: type: object properties: annotationId: type: string minLength: 1 maxLength: 200 x-nitsor-trim: true answers: minItems: 1 maxItems: 128 type: array items: $ref: '#/components/schemas/VersionGraphAnnotationAnswerOutput' description: Sorted by `fieldId`, each field at most once. assetId: type: string minLength: 1 maxLength: 200 x-nitsor-trim: true classId: type: string minLength: 1 maxLength: 200 x-nitsor-trim: true geometry: $ref: '#/components/schemas/VersionGraphGeometry' note: type: string maxLength: 1000 provenance: $ref: '#/components/schemas/VersionGraphAnnotationProvenance' reviewState: $ref: '#/components/schemas/VersionGraphReviewState' required: - annotationId - assetId - classId - geometry - note - reviewState VersionGraphClassificationAnswerOutput: type: object properties: assetId: type: string minLength: 1 maxLength: 200 x-nitsor-trim: true fieldId: type: string minLength: 1 maxLength: 200 x-nitsor-trim: true scope: $ref: '#/components/schemas/VersionGraphAnswerScope' scopeKey: type: string minLength: 1 maxLength: 200 x-nitsor-trim: true value: $ref: '#/components/schemas/VersionGraphAnswerValueOutput' required: - assetId - fieldId - scope - scopeKey - value Sha256Digest: type: string pattern: ^sha256:([0-9a-f]{64})$ VersionGraphLandmark: type: object properties: annotationId: type: string minLength: 1 maxLength: 200 x-nitsor-trim: true assetId: type: string minLength: 1 maxLength: 200 x-nitsor-trim: true classId: type: string minLength: 1 maxLength: 200 x-nitsor-trim: true note: type: string maxLength: 1000 position: $ref: '#/components/schemas/VersionGraphLandmarkPosition' reviewState: $ref: '#/components/schemas/VersionGraphReviewState' required: - annotationId - assetId - classId - note - position - reviewState NextCursor: anyOf: - type: string - type: 'null' VersionGraphPosition: type: object properties: branchId: type: string minLength: 1 maxLength: 200 x-nitsor-trim: true eventSeq: type: integer exclusiveMinimum: 0 required: - branchId - eventSeq NitsorError: anyOf: - $ref: '#/components/schemas/ErrorAuthorizationDenied' - $ref: '#/components/schemas/ErrorValidation' - $ref: '#/components/schemas/ErrorNotFound' - $ref: '#/components/schemas/ErrorAuth' - $ref: '#/components/schemas/ErrorMethodNotAllowed' - $ref: '#/components/schemas/ErrorCheckpointRequired' - $ref: '#/components/schemas/ErrorManifest' - $ref: '#/components/schemas/ErrorDomain' VersionGraphAnnotationAnswerOutput: type: object properties: fieldId: type: string minLength: 1 maxLength: 200 x-nitsor-trim: true value: $ref: '#/components/schemas/VersionGraphAnswerValueOutput' required: - fieldId - value VersionGraphGeometry: oneOf: - $ref: '#/components/schemas/VersionGraphGeometryLandmark' - $ref: '#/components/schemas/VersionGraphGeometryBox2d' - $ref: '#/components/schemas/VersionGraphGeometryBox3d' - $ref: '#/components/schemas/VersionGraphGeometryMask' - $ref: '#/components/schemas/VersionGraphGeometryStroke' - $ref: '#/components/schemas/VersionGraphGeometryPolygon' - $ref: '#/components/schemas/VersionGraphGeometryPolyline' - $ref: '#/components/schemas/VersionGraphGeometryLength' - $ref: '#/components/schemas/VersionGraphGeometryAngle' type: object discriminator: propertyName: kind mapping: landmark: '#/components/schemas/VersionGraphGeometryLandmark' box2d: '#/components/schemas/VersionGraphGeometryBox2d' box3d: '#/components/schemas/VersionGraphGeometryBox3d' mask: '#/components/schemas/VersionGraphGeometryMask' stroke: '#/components/schemas/VersionGraphGeometryStroke' polygon: '#/components/schemas/VersionGraphGeometryPolygon' polyline: '#/components/schemas/VersionGraphGeometryPolyline' length: '#/components/schemas/VersionGraphGeometryLength' angle: '#/components/schemas/VersionGraphGeometryAngle' description: >- `box2d` and `box3d` have `min` strictly below `max` on every axis; `stroke` and `polygon` carry flat finite `u,v` pairs, at least 2 points for a stroke and 3 for a polygon, and at most 2048 points. `polyline`, `length` and `angle` live in volume coordinates, like a landmark: each vertex is `x,y` as fractions of the volume's extent and `z` as the storage slice index. A polyline carries flat finite `x,y,z` triples, 2 to 2048 vertices, open and never closed, with no vertex repeating the one before it. A length's `start` and `end` differ, and each of an angle's `from` and `to` differs from its `vertex`. A length or an angle is stored with its two ends or arms in position order (by `z`, then `y`, then `x`), so one drawn the other way round reads back swapped. No measured value is stored. VersionGraphAnnotationProvenance: oneOf: - $ref: '#/components/schemas/VersionGraphModelProvenance' - $ref: '#/components/schemas/VersionGraphImportProvenance' type: object discriminator: propertyName: kind mapping: model: '#/components/schemas/VersionGraphModelProvenance' import: '#/components/schemas/VersionGraphImportProvenance' VersionGraphReviewState: type: string enum: - accepted - corrected - draft - rejected VersionGraphAnswerScope: type: string enum: - image - study - volume VersionGraphAnswerValueOutput: oneOf: - $ref: '#/components/schemas/VersionGraphAnswerValueBooleanOutput' - $ref: '#/components/schemas/VersionGraphAnswerValueMultiSelectOutput' - $ref: '#/components/schemas/VersionGraphAnswerValueNumericOutput' - $ref: '#/components/schemas/VersionGraphAnswerValueSelectOutput' - $ref: '#/components/schemas/VersionGraphAnswerValueTextOutput' type: object discriminator: propertyName: kind mapping: boolean: '#/components/schemas/VersionGraphAnswerValueBooleanOutput' multi-select: '#/components/schemas/VersionGraphAnswerValueMultiSelectOutput' numeric: '#/components/schemas/VersionGraphAnswerValueNumericOutput' select: '#/components/schemas/VersionGraphAnswerValueSelectOutput' text: '#/components/schemas/VersionGraphAnswerValueTextOutput' VersionGraphLandmarkPosition: type: object properties: x: type: number 'y': type: number z: type: number required: - x - 'y' - z ErrorAuthorizationDenied: type: object properties: requestId: $ref: '#/components/schemas/RequestId' retryable: type: boolean reason: type: string minLength: 1 code: type: string const: AUTHORIZATION_DENIED decisionId: type: string minLength: 1 message: type: string minLength: 1 missingScope: type: string minLength: 1 required: - requestId - retryable - code - message - missingScope ErrorValidation: type: object properties: requestId: $ref: '#/components/schemas/RequestId' retryable: type: boolean reason: type: string minLength: 1 code: type: string const: INVALID_ARGUMENT fieldPath: type: string minLength: 1 message: type: string minLength: 1 remediation: type: string minLength: 1 required: - requestId - retryable - code - message ErrorNotFound: type: object properties: requestId: $ref: '#/components/schemas/RequestId' retryable: type: boolean reason: type: string minLength: 1 code: type: string const: ACCOUNT_NOT_FOUND message: type: string minLength: 1 required: - requestId - retryable - code - message ErrorAuth: type: object properties: requestId: $ref: '#/components/schemas/RequestId' retryable: type: boolean reason: type: string minLength: 1 code: type: string enum: - AUTH_REQUIRED - AUTH_INVALID_TOKEN expiredAt: $ref: '#/components/schemas/UtcTimestamp' message: type: string minLength: 1 remediation: type: string minLength: 1 required: - requestId - retryable - code - message - remediation ErrorMethodNotAllowed: type: object properties: requestId: $ref: '#/components/schemas/RequestId' retryable: type: boolean reason: type: string minLength: 1 code: type: string const: METHOD_NOT_ALLOWED message: type: string minLength: 1 remediation: type: string minLength: 1 required: - requestId - retryable - code - message - remediation ErrorCheckpointRequired: type: object properties: branchId: type: string minLength: 1 maxLength: 200 x-nitsor-trim: true headEventSeq: type: integer exclusiveMinimum: 0 lastEventSeq: type: integer exclusiveMinimum: 0 maxUncommittedEvents: type: number const: 256 requestId: $ref: '#/components/schemas/RequestId' retryable: type: boolean reason: type: string minLength: 1 code: type: string const: CHECKPOINT_REQUIRED message: type: string minLength: 1 remediation: type: string minLength: 1 required: - branchId - headEventSeq - lastEventSeq - maxUncommittedEvents - requestId - retryable - code - message - remediation ErrorManifest: type: object properties: requestId: $ref: '#/components/schemas/RequestId' retryable: type: boolean reason: type: string minLength: 1 code: type: string const: NO_VALID_DICOM_SLICES manifest: type: array items: $ref: '#/components/schemas/SourceManifestEntry' message: type: string minLength: 1 remediation: type: string minLength: 1 required: - requestId - retryable - code - manifest - message - remediation ErrorDomain: type: object properties: requestId: $ref: '#/components/schemas/RequestId' retryable: type: boolean reason: type: string minLength: 1 code: type: string enum: - API_ERROR - API_UNREACHABLE - CORRUPT_DICOM - CORRUPT_TIFF_STACK - CORRUPT_VGI - DATASET_NAME_CONFLICT - DATASET_NOT_FOUND - DATASET_REVISION_CONFLICT - DATASET_VERSION_NOT_FOUND - DATASET_VERSION_RESOLVING - DATASET_VERSION_NAME_CONFLICT - DATASET_HEAD_UNCOMMITTED - DATASET_NO_QUALIFYING_COMMIT - DATASET_MEMBERSHIP_UNDECLARED - DATASET_HARD_MEMBER_MISSING - DATASET_HARD_MEMBER_EXCLUDED - DATASET_SELECTION_EMPTY - DATASET_OBJECT_MISSING - DATASET_OBJECT_CHANGED - DATASET_MEMBER_TOO_LARGE - DATASET_LAYOUT_UNSATISFIABLE - DATASET_BUILD_UNAVAILABLE - DATASET_BUILD_INVALID - DATASET_FREEZE_TIMEOUT - DATASET_MANIFEST_HASH_MISMATCH - DATASET_READ_SESSION_NOT_FOUND - DATASET_READ_SESSION_CLOSED - DATASET_VERSION_REVOKED - DATASET_VERSION_TOMBSTONED - DATASET_VERSION_CANCELLED - DUPLICATE_SOP_INSTANCE_UID - GEOMETRY_INCONSISTENT - GEOMETRY_OUT_OF_RANGE - IDEMPOTENCY_CONFLICT - INVALID_JSON - MISSING_SLICE - MIXED_FORMAT_FAMILIES - MODEL_RUN_ESTIMATE_CHANGED - MODEL_RUN_MULTI_ITEM_UNSUPPORTED - MODEL_RUN_SCAN_TOO_LARGE - MODEL_RUN_NOT_OFFERED - PROJECT_CREATE_FAILED - RATE_LIMITED - REQUEST_NOT_CANCELLABLE - REQUEST_NOT_FOUND - REQUEST_REPORT_EXPIRED - SERIES_IDENTITY_MISMATCH - SLICE_ORDER_INCONSISTENT - SOURCE_LIST_FAILED - SOURCE_REGISTER_FAILED - SOURCE_VERSION_AMBIGUOUS - STORAGE_CONNECTION_REGISTER_FAILED - STORAGE_CREDENTIAL_ENVIRONMENT_FORBIDDEN - STORAGE_CREDENTIAL_HANDLE_CONFLICT - STORAGE_CREDENTIAL_HANDLE_INVALID - STORAGE_CREDENTIAL_HANDLE_NOT_FOUND - STORAGE_CREDENTIAL_HANDLE_REQUIRED - STORAGE_CREDENTIAL_PRESIGN_UNSUPPORTED - STORAGE_CREDENTIAL_ROLE_MISMATCH - STORAGE_CREDENTIAL_TARGET_MISMATCH - STORAGE_CREDENTIAL_UNAVAILABLE - STORAGE_CUSTOM_HOSTS_NOT_READY - STORAGE_OBJECT_CHANGED_DURING_READ - STORAGE_OBJECT_NOT_FOUND - STORAGE_OBJECT_TOO_LARGE - STORAGE_READ_FAILED - UNEXPECTED_ERROR - UNKNOWN_COMMAND - UNSUPPORTED_PIXEL_FORMAT - UNSUPPORTED_TRANSFER_SYNTAX - UNSUPPORTED_VGI_SCENE - UNRECOGNIZED_FORMAT - VERSION_GRAPH_OPERATION_FAILED - VGI_VOL_MISMATCH - TAXONOMY_OPERATION_FAILED - WORKFLOW_OPERATION_FAILED message: type: string minLength: 1 remediation: type: string minLength: 1 required: - requestId - retryable - code - message - remediation VersionGraphGeometryLandmark: type: object properties: kind: type: string const: landmark position: $ref: '#/components/schemas/VersionGraphLandmarkPosition' required: - kind - position VersionGraphGeometryBox2d: type: object properties: axis: type: string enum: - x - 'y' - z kind: type: string const: box2d max: type: object properties: u: type: number v: type: number required: - u - v min: type: object properties: u: type: number v: type: number required: - u - v sliceIndex: type: integer minimum: 0 required: - axis - kind - max - min - sliceIndex VersionGraphGeometryBox3d: type: object properties: kind: type: string const: box3d max: $ref: '#/components/schemas/VersionGraphLandmarkPosition' min: $ref: '#/components/schemas/VersionGraphLandmarkPosition' required: - kind - max - min VersionGraphGeometryMask: type: object properties: kind: type: string const: mask manifest: type: object properties: chunkCount: type: integer exclusiveMinimum: 0 manifestHash: $ref: '#/components/schemas/Sha256Digest' required: - chunkCount - manifestHash required: - kind - manifest VersionGraphGeometryStroke: type: object properties: axis: type: string enum: - x - 'y' - z kind: type: string const: stroke points: type: array items: type: number radius: type: number exclusiveMinimum: 0 sliceIndex: type: integer minimum: 0 required: - axis - kind - points - radius - sliceIndex VersionGraphGeometryPolygon: type: object properties: axis: type: string enum: - x - 'y' - z kind: type: string const: polygon points: type: array items: type: number sliceIndex: type: integer minimum: 0 required: - axis - kind - points - sliceIndex VersionGraphGeometryPolyline: type: object properties: kind: type: string const: polyline points: type: array items: type: number required: - kind - points VersionGraphGeometryLength: type: object properties: end: $ref: '#/components/schemas/VersionGraphLandmarkPosition' kind: type: string const: length start: $ref: '#/components/schemas/VersionGraphLandmarkPosition' required: - end - kind - start VersionGraphGeometryAngle: type: object properties: from: $ref: '#/components/schemas/VersionGraphLandmarkPosition' kind: type: string const: angle to: $ref: '#/components/schemas/VersionGraphLandmarkPosition' vertex: $ref: '#/components/schemas/VersionGraphLandmarkPosition' required: - from - kind - to - vertex VersionGraphModelProvenance: type: object properties: componentId: type: string minLength: 1 maxLength: 200 x-nitsor-trim: true componentIds: minItems: 1 maxItems: 128 type: array items: type: string minLength: 1 maxLength: 200 x-nitsor-trim: true disposition: type: string enum: - accepted - corrected jobId: type: string minLength: 1 maxLength: 200 x-nitsor-trim: true kind: type: string const: model modelFamily: type: string minLength: 1 maxLength: 200 x-nitsor-trim: true modelVersion: type: string minLength: 1 maxLength: 200 x-nitsor-trim: true proposalId: type: string minLength: 1 maxLength: 200 x-nitsor-trim: true runId: type: string minLength: 1 maxLength: 200 x-nitsor-trim: true setupVersion: type: string minLength: 1 maxLength: 200 x-nitsor-trim: true required: - disposition - kind - modelFamily - modelVersion - proposalId VersionGraphImportProvenance: type: object properties: catalogRelease: type: string minLength: 1 maxLength: 200 x-nitsor-trim: true dataset: type: string minLength: 1 maxLength: 200 x-nitsor-trim: true declaredAuthor: type: string enum: - person disposition: type: string enum: - accepted - corrected fileSha256: type: string pattern: ^[0-9a-f]{64}$ kind: type: string const: import licence: type: string enum: - CC0-1.0 - CC-BY-3.0 - CC-BY-4.0 - ODC-By-1.0 - NIST-PD required: - catalogRelease - dataset - declaredAuthor - disposition - fileSha256 - kind - licence VersionGraphAnswerValueBooleanOutput: type: object properties: kind: type: string const: boolean value: type: boolean required: - kind - value VersionGraphAnswerValueMultiSelectOutput: type: object properties: kind: type: string const: multi-select optionIds: minItems: 1 maxItems: 128 type: array items: type: string minLength: 1 maxLength: 200 x-nitsor-trim: true required: - kind - optionIds description: '`optionIds` is sorted and unique.' VersionGraphAnswerValueNumericOutput: type: object properties: kind: type: string const: numeric value: type: number required: - kind - value VersionGraphAnswerValueSelectOutput: type: object properties: kind: type: string const: select optionId: type: string minLength: 1 maxLength: 200 x-nitsor-trim: true required: - kind - optionId VersionGraphAnswerValueTextOutput: type: object properties: kind: type: string const: text value: type: string maxLength: 1000 required: - kind - value RequestId: type: string minLength: 1 maxLength: 128 pattern: ^[\x21-\x7e]+$ UtcTimestamp: type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z|[+-]00:00))$ description: >- RFC 3339 timestamp in UTC: the offset is `Z` or `+00:00`; any other offset is refused. SourceManifestEntry: type: object properties: byteSize: type: integer minimum: 0 checksum: $ref: '#/components/schemas/Sha256Digest' contentFingerprint: $ref: '#/components/schemas/Sha256Digest' errors: maxItems: 1 type: array items: $ref: '#/components/schemas/IngestIssue' etag: type: string minLength: 1 etagWeak: type: boolean instanceNumber: type: integer objectKey: type: string minLength: 1 pixelDataByteOffset: type: integer minimum: 0 positionMm: type: number role: type: string enum: - descriptor - voxel-data sopInstanceUid: type: string minLength: 1 status: type: string enum: - registered - rejected required: - errors - objectKey - status IngestIssue: type: object properties: code: $ref: '#/components/schemas/IssueCode' fieldPath: type: string message: type: string minLength: 1 maxLength: 250 remediation: type: string minLength: 1 maxLength: 100 required: - code - message - remediation IssueCode: type: string enum: - ACCOUNT_NOT_FOUND - API_ERROR - API_UNREACHABLE - AUTHORIZATION_DENIED - AUTH_INVALID_TOKEN - AUTH_REQUIRED - CHECKPOINT_REQUIRED - CORRUPT_VGI - CORRUPT_DICOM - CORRUPT_TIFF_STACK - DATASET_NAME_CONFLICT - DATASET_NOT_FOUND - DATASET_REVISION_CONFLICT - DATASET_VERSION_NOT_FOUND - DATASET_VERSION_RESOLVING - DATASET_VERSION_NAME_CONFLICT - DATASET_HEAD_UNCOMMITTED - DATASET_NO_QUALIFYING_COMMIT - DATASET_MEMBERSHIP_UNDECLARED - DATASET_HARD_MEMBER_MISSING - DATASET_HARD_MEMBER_EXCLUDED - DATASET_SELECTION_EMPTY - DATASET_OBJECT_MISSING - DATASET_OBJECT_CHANGED - DATASET_MEMBER_TOO_LARGE - DATASET_LAYOUT_UNSATISFIABLE - DATASET_BUILD_UNAVAILABLE - DATASET_BUILD_INVALID - DATASET_FREEZE_TIMEOUT - DATASET_VERSION_CANCELLED - DATASET_MANIFEST_HASH_MISMATCH - DATASET_READ_SESSION_NOT_FOUND - DATASET_READ_SESSION_CLOSED - DATASET_VERSION_REVOKED - DATASET_VERSION_TOMBSTONED - DUPLICATE_SOP_INSTANCE_UID - GEOMETRY_INCONSISTENT - GEOMETRY_OUT_OF_RANGE - IDEMPOTENCY_CONFLICT - INVALID_ARGUMENT - INVALID_JSON - METHOD_NOT_ALLOWED - MISSING_SLICE - MIXED_FORMAT_FAMILIES - MODEL_RUN_BUDGET_EXHAUSTED - MODEL_RUN_ESTIMATE_CHANGED - MODEL_RUN_ITEM_LANDS_FROM_JOB - MODEL_RUN_ITEM_SETTLED - MODEL_RUN_LANDED_LATE - MODEL_RUN_MODEL_FAILED - MODEL_RUN_MULTI_ITEM_UNSUPPORTED - MODEL_RUN_NOT_OFFERED - MODEL_RUN_PIN_CHANGED - MODEL_RUN_REPLACEMENT_CHANGED - MODEL_RUN_REPORT_EXPIRED - MODEL_RUN_REQUEST_STOPPING - MODEL_RUN_SCAN_TOO_LARGE - MODEL_RUN_SOURCE_CHANGED - MODEL_RUN_SUPERSEDED - MODEL_RUN_TASK_BINDING_LOST - MODEL_RUN_TASK_NOT_ELIGIBLE - MODEL_RUN_TIME_LIMIT - NO_VALID_DICOM_SLICES - PROJECT_CREATE_FAILED - RATE_LIMITED - REQUEST_LANDING_TOO_LARGE - REQUEST_NOT_CANCELLABLE - REQUEST_NOT_FOUND - REQUEST_REPORT_EXPIRED - REQUEST_WORKER_EXHAUSTED - SERIES_IDENTITY_MISMATCH - SERVER_VERSION_INCOMPATIBLE - SLICE_ORDER_INCONSISTENT - SOURCE_LIST_FAILED - SOURCE_REGISTER_FAILED - SOURCE_VERSION_AMBIGUOUS - STORAGE_CONNECTION_REGISTER_FAILED - STORAGE_CREDENTIAL_ENVIRONMENT_FORBIDDEN - STORAGE_CREDENTIAL_HANDLE_CONFLICT - STORAGE_CREDENTIAL_HANDLE_INVALID - STORAGE_CREDENTIAL_HANDLE_NOT_FOUND - STORAGE_CREDENTIAL_HANDLE_REQUIRED - STORAGE_CREDENTIAL_PRESIGN_UNSUPPORTED - STORAGE_CREDENTIAL_ROLE_MISMATCH - STORAGE_CREDENTIAL_TARGET_MISMATCH - STORAGE_CREDENTIAL_UNAVAILABLE - STORAGE_CUSTOM_HOSTS_NOT_READY - STORAGE_OBJECT_CHANGED_DURING_READ - STORAGE_OBJECT_NOT_FOUND - STORAGE_OBJECT_TOO_LARGE - STORAGE_READ_FAILED - UNEXPECTED_ERROR - UNKNOWN_COMMAND - UNSUPPORTED_VGI_SCENE - UNSUPPORTED_PIXEL_FORMAT - UNSUPPORTED_TRANSFER_SYNTAX - UNRECOGNIZED_FORMAT - VERSION_GRAPH_OPERATION_FAILED - VGI_VOL_MISMATCH - TAXONOMY_OPERATION_FAILED - WORKFLOW_OPERATION_FAILED headers: RequestId: description: The request id every answer carries; echo it when reporting a problem. schema: type: string TokenExpires: description: >- The instant the credential that made the request stops working, RFC 3339 in UTC. Sent on every authenticated answer, a refusal after authentication included, once the credential has 14 days or fewer left. Never sent on a 401 or a 405, or by a route that needs no credential. schema: type: string format: date-time RetryAfter: description: >- Whole seconds to wait before polling an accepted Request or retrying a 429 refusal. schema: type: integer minimum: 0 responses: NitsorErrorAuthenticated: description: >- The request was refused. `code` names the refusal; `requestId` correlates it. headers: X-Request-Id: $ref: '#/components/headers/RequestId' Retry-After: $ref: '#/components/headers/RetryAfter' Nitsor-Token-Expires: $ref: '#/components/headers/TokenExpires' content: application/json: schema: $ref: '#/components/schemas/NitsorError' NitsorError: description: >- The request was refused. `code` names the refusal; `requestId` correlates it. headers: X-Request-Id: $ref: '#/components/headers/RequestId' Retry-After: $ref: '#/components/headers/RetryAfter' content: application/json: schema: $ref: '#/components/schemas/NitsorError' securitySchemes: bearerAuth: type: http scheme: bearer description: >- An Agent credential (`nits_…`), or a person token (`nitp_…`) on a deployment that enables them. `GET /api/v1/session` names the principal a credential proves. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.