> ## 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. # Discover server capabilities and version floors ## OpenAPI ````yaml /openapi.json get /api/v1/capabilities 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/capabilities: get: tags: - capabilities summary: Discover server capabilities and version floors operationId: capabilitiesGet responses: '200': description: Discover server capabilities and version floors headers: X-Request-Id: $ref: '#/components/headers/RequestId' content: application/json: schema: $ref: '#/components/schemas/CapabilitiesResponse' '400': $ref: '#/components/responses/NitsorError' '401': $ref: '#/components/responses/NitsorError' '403': $ref: '#/components/responses/NitsorError' '404': $ref: '#/components/responses/NitsorError' '405': $ref: '#/components/responses/NitsorError' '409': $ref: '#/components/responses/NitsorError' '413': $ref: '#/components/responses/NitsorError' '422': $ref: '#/components/responses/NitsorError' '429': $ref: '#/components/responses/NitsorError' security: [] components: headers: RequestId: description: The request id every answer carries; echo it when reporting a problem. schema: type: string RetryAfter: description: >- Whole seconds to wait before polling an accepted Request or retrying a 429 refusal. schema: type: integer minimum: 0 schemas: CapabilitiesResponse: type: object properties: productVersion: type: string minLength: 1 apiVersion: type: string minLength: 1 deployment: $ref: '#/components/schemas/DeploymentTopology' formats: $ref: '#/components/schemas/CapabilityFormats' limits: $ref: '#/components/schemas/CapabilityLimits' minimumVersions: $ref: '#/components/schemas/RouteMinimumVersions' required: - productVersion - apiVersion - deployment - formats - limits - minimumVersions DeploymentTopology: type: object properties: bulkData: type: string enum: - customer-object-storage controlPlane: type: string enum: - convex transfer: type: string enum: - presigned-url required: - bulkData - controlPlane - transfer CapabilityFormats: type: object properties: rawSliceEncodings: minItems: 1 type: array items: $ref: '#/components/schemas/RawSliceEncoding' sourceFormats: minItems: 1 type: array items: $ref: '#/components/schemas/SourceFormat' required: - rawSliceEncodings - sourceFormats CapabilityLimits: type: object properties: datasetMaxMembers: type: integer exclusiveMinimum: 0 datasetChunkBytes: type: integer exclusiveMinimum: 0 datasetShardArtifactBytes: type: integer exclusiveMinimum: 0 datasetLeaseSeconds: type: integer exclusiveMinimum: 0 datasetPresignKeysPerBatch: type: integer exclusiveMinimum: 0 idempotencyKeyRetentionHours: type: integer exclusiveMinimum: 0 maxDisplayNameLength: type: integer exclusiveMinimum: 0 maxIdempotencyKeyLength: type: integer exclusiveMinimum: 0 maxIdentifierLength: type: integer exclusiveMinimum: 0 maxPageSize: type: integer exclusiveMinimum: 0 maxPresignObjectKeysPerRequest: type: integer exclusiveMinimum: 0 maxRequestBodyBytes: type: integer exclusiveMinimum: 0 maxRequestIdLength: type: integer exclusiveMinimum: 0 maxRequestItemInputBytes: type: integer exclusiveMinimum: 0 maxRequestItemWorkMinutes: type: integer exclusiveMinimum: 0 maxRequestItems: type: integer exclusiveMinimum: 0 maxRequestLandingWrites: type: integer exclusiveMinimum: 0 maxRequestResultRefKindLength: type: integer exclusiveMinimum: 0 maxRequestResultRefs: type: integer exclusiveMinimum: 0 maxSourceObjectBytes: type: integer exclusiveMinimum: 0 maxSourceObjectKeyLength: type: integer exclusiveMinimum: 0 maxSourceObjectKeys: type: integer exclusiveMinimum: 0 taskBatchRaiseIssueMaxTasks: type: integer exclusiveMinimum: 0 required: - datasetMaxMembers - datasetChunkBytes - datasetShardArtifactBytes - datasetLeaseSeconds - datasetPresignKeysPerBatch - idempotencyKeyRetentionHours - maxDisplayNameLength - maxIdempotencyKeyLength - maxIdentifierLength - maxPageSize - maxPresignObjectKeysPerRequest - maxRequestBodyBytes - maxRequestIdLength - maxRequestItemInputBytes - maxRequestItemWorkMinutes - maxRequestItems - maxRequestLandingWrites - maxRequestResultRefKindLength - maxRequestResultRefs - maxSourceObjectBytes - maxSourceObjectKeyLength - maxSourceObjectKeys RouteMinimumVersions: type: object propertyNames: type: string enum: - capabilitiesGet - openapiDocument - decisionsList - ledgerList - projectAssetsAttach - projectsCreate - projectsList - session - sourceMaskReadPresign - sourceRepresentationStatus - sourceRepresentationPresign - sourceRepresentationPlanesStatus - sourceRepresentationPlanePresign - sourcesList - sourcesRegister - storageConnectionsCreate - storageConnectionsGet - storageCredentialHandlesList - storageCredentialsAdd - versionGraphAnnotationCommit - versionGraphBranchCreate - versionGraphBranchesList - versionGraphCommitCreate - versionGraphLandmarkDelete - versionGraphLandmarkUpsert - versionGraphMerge - versionGraphPosition - versionGraphProjectMetadataUpdate - taskCommentsList - taskCommentsWrite - taskCommentsReplies - taskCommentsAttention - executionsList - executionDetail - executionWorkItems - modelLabelOutcomesProposal - modelLabelOutcomesTask - blindCheckPlanGet - blindCheckPlanRate - blindCheckPlanStart - blindCheckPlanStop - blindCheckPlansList - blindChecksList - taxonomy - taxonomyBind - workflowDefinition - workflowDefinitionBind - asyncRequestsGet - asyncRequestsList - asyncRequestsCancel - asyncRequestsItems - datasetsCreate - datasetsList - datasetsGet - datasetsRevise - projectGroupsCreate - projectGroupsDelete - projectGroupsList - projectGroupsMove - projectGroupsRename - projectShelfList - projectsSetGroup - datasetVersionsCreate - datasetVersionsGet - datasetVersionsList - datasetVersionsExclusions - datasetVersionsStats - datasetVersionsLabels - datasetVersionsAccess - datasetVersionsPin - datasetVersionsDelete - modelRunsCreate - modelRunsEstimate - serviceAccountsList - serviceAccountsCreate - serviceAccountsGet - serviceAccountsUpdate - serviceAccountsDisable - serviceAccountsEnable - serviceAccountsRetire - serviceAccountsSetPermissions - serviceAccountsSetOwner - serviceAccountTokensCreate - serviceAccountTokensRevoke - serviceAccountTokensReplace - serviceAccountTokensShorten - projectServiceAccountsList - projectServiceAccountsGrant - projectServiceAccountsRemove additionalProperties: $ref: '#/components/schemas/ProductVersion' required: - capabilitiesGet - openapiDocument - decisionsList - ledgerList - projectAssetsAttach - projectsCreate - projectsList - session - sourceMaskReadPresign - sourceRepresentationStatus - sourceRepresentationPresign - sourceRepresentationPlanesStatus - sourceRepresentationPlanePresign - sourcesList - sourcesRegister - storageConnectionsCreate - storageConnectionsGet - storageCredentialHandlesList - storageCredentialsAdd - versionGraphAnnotationCommit - versionGraphBranchCreate - versionGraphBranchesList - versionGraphCommitCreate - versionGraphLandmarkDelete - versionGraphLandmarkUpsert - versionGraphMerge - versionGraphPosition - versionGraphProjectMetadataUpdate - taskCommentsList - taskCommentsWrite - taskCommentsReplies - taskCommentsAttention - executionsList - executionDetail - executionWorkItems - modelLabelOutcomesProposal - modelLabelOutcomesTask - blindCheckPlanGet - blindCheckPlanRate - blindCheckPlanStart - blindCheckPlanStop - blindCheckPlansList - blindChecksList - taxonomy - taxonomyBind - workflowDefinition - workflowDefinitionBind - asyncRequestsGet - asyncRequestsList - asyncRequestsCancel - asyncRequestsItems - datasetsCreate - datasetsList - datasetsGet - datasetsRevise - projectGroupsCreate - projectGroupsDelete - projectGroupsList - projectGroupsMove - projectGroupsRename - projectShelfList - projectsSetGroup - datasetVersionsCreate - datasetVersionsGet - datasetVersionsList - datasetVersionsExclusions - datasetVersionsStats - datasetVersionsLabels - datasetVersionsAccess - datasetVersionsPin - datasetVersionsDelete - modelRunsCreate - modelRunsEstimate - serviceAccountsList - serviceAccountsCreate - serviceAccountsGet - serviceAccountsUpdate - serviceAccountsDisable - serviceAccountsEnable - serviceAccountsRetire - serviceAccountsSetPermissions - serviceAccountsSetOwner - serviceAccountTokensCreate - serviceAccountTokensRevoke - serviceAccountTokensReplace - serviceAccountTokensShorten - projectServiceAccountsList - projectServiceAccountsGrant - projectServiceAccountsRemove properties: capabilitiesGet: $ref: '#/components/schemas/ProductVersion' openapiDocument: $ref: '#/components/schemas/ProductVersion' decisionsList: $ref: '#/components/schemas/ProductVersion' ledgerList: $ref: '#/components/schemas/ProductVersion' projectAssetsAttach: $ref: '#/components/schemas/ProductVersion' projectsCreate: $ref: '#/components/schemas/ProductVersion' projectsList: $ref: '#/components/schemas/ProductVersion' session: $ref: '#/components/schemas/ProductVersion' sourceMaskReadPresign: $ref: '#/components/schemas/ProductVersion' sourceRepresentationStatus: $ref: '#/components/schemas/ProductVersion' sourceRepresentationPresign: $ref: '#/components/schemas/ProductVersion' sourceRepresentationPlanesStatus: $ref: '#/components/schemas/ProductVersion' sourceRepresentationPlanePresign: $ref: '#/components/schemas/ProductVersion' sourcesList: $ref: '#/components/schemas/ProductVersion' sourcesRegister: $ref: '#/components/schemas/ProductVersion' storageConnectionsCreate: $ref: '#/components/schemas/ProductVersion' storageConnectionsGet: $ref: '#/components/schemas/ProductVersion' storageCredentialHandlesList: $ref: '#/components/schemas/ProductVersion' storageCredentialsAdd: $ref: '#/components/schemas/ProductVersion' versionGraphAnnotationCommit: $ref: '#/components/schemas/ProductVersion' versionGraphBranchCreate: $ref: '#/components/schemas/ProductVersion' versionGraphBranchesList: $ref: '#/components/schemas/ProductVersion' versionGraphCommitCreate: $ref: '#/components/schemas/ProductVersion' versionGraphLandmarkDelete: $ref: '#/components/schemas/ProductVersion' versionGraphLandmarkUpsert: $ref: '#/components/schemas/ProductVersion' versionGraphMerge: $ref: '#/components/schemas/ProductVersion' versionGraphPosition: $ref: '#/components/schemas/ProductVersion' versionGraphProjectMetadataUpdate: $ref: '#/components/schemas/ProductVersion' taskCommentsList: $ref: '#/components/schemas/ProductVersion' taskCommentsWrite: $ref: '#/components/schemas/ProductVersion' taskCommentsReplies: $ref: '#/components/schemas/ProductVersion' taskCommentsAttention: $ref: '#/components/schemas/ProductVersion' executionsList: $ref: '#/components/schemas/ProductVersion' executionDetail: $ref: '#/components/schemas/ProductVersion' executionWorkItems: $ref: '#/components/schemas/ProductVersion' modelLabelOutcomesProposal: $ref: '#/components/schemas/ProductVersion' modelLabelOutcomesTask: $ref: '#/components/schemas/ProductVersion' blindCheckPlanGet: $ref: '#/components/schemas/ProductVersion' blindCheckPlanRate: $ref: '#/components/schemas/ProductVersion' blindCheckPlanStart: $ref: '#/components/schemas/ProductVersion' blindCheckPlanStop: $ref: '#/components/schemas/ProductVersion' blindCheckPlansList: $ref: '#/components/schemas/ProductVersion' blindChecksList: $ref: '#/components/schemas/ProductVersion' taxonomy: $ref: '#/components/schemas/ProductVersion' taxonomyBind: $ref: '#/components/schemas/ProductVersion' workflowDefinition: $ref: '#/components/schemas/ProductVersion' workflowDefinitionBind: $ref: '#/components/schemas/ProductVersion' asyncRequestsGet: $ref: '#/components/schemas/ProductVersion' asyncRequestsList: $ref: '#/components/schemas/ProductVersion' asyncRequestsCancel: $ref: '#/components/schemas/ProductVersion' asyncRequestsItems: $ref: '#/components/schemas/ProductVersion' datasetsCreate: $ref: '#/components/schemas/ProductVersion' datasetsList: $ref: '#/components/schemas/ProductVersion' datasetsGet: $ref: '#/components/schemas/ProductVersion' datasetsRevise: $ref: '#/components/schemas/ProductVersion' projectGroupsCreate: $ref: '#/components/schemas/ProductVersion' projectGroupsDelete: $ref: '#/components/schemas/ProductVersion' projectGroupsList: $ref: '#/components/schemas/ProductVersion' projectGroupsMove: $ref: '#/components/schemas/ProductVersion' projectGroupsRename: $ref: '#/components/schemas/ProductVersion' projectShelfList: $ref: '#/components/schemas/ProductVersion' projectsSetGroup: $ref: '#/components/schemas/ProductVersion' datasetVersionsCreate: $ref: '#/components/schemas/ProductVersion' datasetVersionsGet: $ref: '#/components/schemas/ProductVersion' datasetVersionsList: $ref: '#/components/schemas/ProductVersion' datasetVersionsExclusions: $ref: '#/components/schemas/ProductVersion' datasetVersionsStats: $ref: '#/components/schemas/ProductVersion' datasetVersionsLabels: $ref: '#/components/schemas/ProductVersion' datasetVersionsAccess: $ref: '#/components/schemas/ProductVersion' datasetVersionsPin: $ref: '#/components/schemas/ProductVersion' datasetVersionsDelete: $ref: '#/components/schemas/ProductVersion' modelRunsCreate: $ref: '#/components/schemas/ProductVersion' modelRunsEstimate: $ref: '#/components/schemas/ProductVersion' serviceAccountsList: $ref: '#/components/schemas/ProductVersion' serviceAccountsCreate: $ref: '#/components/schemas/ProductVersion' serviceAccountsGet: $ref: '#/components/schemas/ProductVersion' serviceAccountsUpdate: $ref: '#/components/schemas/ProductVersion' serviceAccountsDisable: $ref: '#/components/schemas/ProductVersion' serviceAccountsEnable: $ref: '#/components/schemas/ProductVersion' serviceAccountsRetire: $ref: '#/components/schemas/ProductVersion' serviceAccountsSetPermissions: $ref: '#/components/schemas/ProductVersion' serviceAccountsSetOwner: $ref: '#/components/schemas/ProductVersion' serviceAccountTokensCreate: $ref: '#/components/schemas/ProductVersion' serviceAccountTokensRevoke: $ref: '#/components/schemas/ProductVersion' serviceAccountTokensReplace: $ref: '#/components/schemas/ProductVersion' serviceAccountTokensShorten: $ref: '#/components/schemas/ProductVersion' projectServiceAccountsList: $ref: '#/components/schemas/ProductVersion' projectServiceAccountsGrant: $ref: '#/components/schemas/ProductVersion' projectServiceAccountsRemove: $ref: '#/components/schemas/ProductVersion' 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' RawSliceEncoding: type: string enum: - raw-uint8 - raw-int8 - raw-uint16-le - raw-int16-le - raw-float32-le SourceFormat: type: string enum: - dicom - mrd - projection-stack - tiff-stack - vgi-vol - nsi-legacy - nsi-hrvol - rek - flt - cb - sbm ProductVersion: type: string pattern: >- ^(?\d+(?:\.\d+)*)(?:-(?(?:0|[1-9]\d*|\d*[A-Za-z-][0-9A-Za-z-]*)(?:\.(?:0|[1-9]\d*|\d*[A-Za-z-][0-9A-Za-z-]*))*))?(?:\+[0-9A-Za-z-]+(?:\.[0-9A-Za-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 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 Sha256Digest: type: string pattern: ^sha256:([0-9a-f]{64})$ 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 responses: 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.