Dentsply Sirona

Dentsply Sirona Intraoral Imaging Filters API

A 9-operation OpenAPI 3.0.1 contract for applying Dentsply Sirona's Select, Supreme and AE image filters to 16-bit grayscale intraoral images. An image resource is created either by uploading a PNG or by referencing a capture in a live Modality API acquisition session, then filters are applied and the filtered PNG returned; the resource is transient and carries an `expires` timestamp after which it is deleted. Like the Modality API it is a LOCAL service on the practice workstation, and it declares no security scheme because it is reached over loopback.

Documentation GitHub OpenAPI

Operations 9

POST /images Create Image Resource #

POST /images/modality Create Modality Resource #

GET /images/{id} Get Image Resource #

DELETE /images/{id} Delete Image Resource #

GET /images/{id}/media Get Image Media #

POST /images/{id}/filters/unmap Unmap image #

POST /images/{id}/filters/select Apply Select Filter #

POST /images/{id}/filters/supreme Apply Supreme Filter #

POST /images/{id}/filters/ae Apply AE Filter #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/dsio-filters-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.0.1

info:
  title: Dentsply Sirona Intraoral Filters API
  description: |
    This API is used to apply custom filters to images acquired from the DSIO Modality API.
  version: "1.0"

servers:
  - url: 'https://localhost:43809/api/dsio/filters/v1'
    description: Default endpoint for local Sensor Plugin service

tags:
  - name: Images
    description: Manage image resources for processing
  - name: Filters
    description: Filters that can be applied to image resources
paths:
  /images:
    post:
      tags: [Images]
      summary: Create Image Resource
      operationId: createImage
      description: |
        Create a new image resource by uploading a 16-bit grayscale PNG image file and information describing the image. When finished with filter oprations, this resource should be deleted with the API call `Delete Image Resource`. Otherwise, the resource will be automatically deleted after the `expires` timestamp.
      requestBody:
        content:
          multipart/form-data:
            schema:
              type: object
              properties:
                imageInfo:
                  $ref: '#/components/schemas/ImageInfo'
                imageMedia:
                  description: The media file to upload. This file must be a 16-bit PNG image.
                  type: string
                  format: binary
            encoding:
              media:
                contentType: image/png
      responses:
        '201':
          description: Image resource created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ImageResource'
        '400':
          description: Bad input parameter
        '415':
          description: Unsupported media type
  /images/modality:
    post:
      tags: [Images]
      summary: Create Modality Resource
      operationId: modalityImage
      description: |
        Create a new image resource by referencing an image captured in a current modality session using the DSIO Modality API. This resource will only be available as long as the modality session is active. When finished with filter oprations, this resource should be deleted with the API call `Delete Image Resource`. Otherwise, the resource will be automatically deleted after the `expires` timestamp.
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ModalitySession'
      responses:
        '201':
          description: Image resource created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ImageResource'
        '400':
          description: Bad input parameter
        '404':
          description: Modality session or image not found
  /images/{id}:
    get:
      tags: [Images]
      summary: Get Image Resource
      operationId: getImage
      description: Retrieves an image resource
      parameters:
        - name: id
          in: path
          description: Id of the image resource to retrieve
          required: true
          schema:
            type: string
            format: text
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ImageResource'
        '404':
          description: Image resource not found
    delete:
      tags: [Images]
      summary: Delete Image Resource
      operationId: deleteImage
      description: |
        Deletes an image resource from the filters service. This image will no longer be available for processing.
      parameters:
        - name: id
          in: path
          description: Id of the image resource to delete
          required: true
          schema:
            type: string
            format: text
      responses:
        '204':
          description: Successfully deleted resource
        '404':
          description: Image resource not found
  /images/{id}/media:
    get:
      tags: [Images]
      summary: Get Image Media
      operationId: getImageMedia
      description: Retrieve the media associated with an image resource
      parameters:
        - name: id
          in: path
          description: Id of the image resource to retrieve
          required: true
          schema:
            type: string
            format: text
      responses:
        '200':
          description: Success
          content:
            image/*:
              schema:
                type: string
                format: binary
        '404':
          description: Image resource not found


  /images/{id}/filters/unmap:
    post:
      tags: [Filters]
      summary: Unmap image
      operationId: unmapImage
      description: |
        Removes the gamma map, described by LutInfo, that was applied to the image and return the original image
      parameters:
        - name: id
          in: path
          description: Id of the image resource to process
          required: true
          schema:
            type: string
            format: text
      responses:
        '200':
          description: Success
          content:
            image/png:
              schema:
                type: string
                format: binary
        '404':
          description: Image resource not found
        '410':
          description: Gone - Image media for this resource could not be found

  /images/{id}/filters/select:
    post:
      tags: [Filters]
      summary: Apply Select Filter
      operationId: filterSelect
      description: |
        Applies the Select Filter to the specified image resource and returns the filtered image. This filter is optimized for images acquired from Xios XG Select and CDR Elite sensors.
      parameters:
        - name: id
          in: path
          description: Id of the image resource to process
          required: true
          schema:
            type: string
            format: text
      requestBody:
          description: The parameters used to process the image
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SelectFilter'
      responses:
        '200':
          description: Success
          content:
            image/png:
              schema:
                type: string
                format: binary
        '400':
          description: Supplied filter contains invalid parameters
        '404':
          description: Image resource not found
        '410':
          description: Gone - Image media for this resource could not be found

  /images/{id}/filters/supreme:
    post:
      tags: [Filters]
      summary: Apply Supreme Filter
      operationId: filterSupreme
      description: |
        Applies the Supreme Filter to the specified image resource and returns the filtered image.
      parameters:
        - name: id
          in: path
          description: Id of the image resource to process
          required: true
          schema:
            type: string
            format: text
      requestBody:
          description: The parameters used to process the image
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SupremeFilter'
      responses:
        '200':
          description: Success
          content:
            image/png:
              schema:
                type: string
                format: binary
        '400':
          description: Supplied filter contains invalid parameters
        '404':
          description: Image resource not found
        '410':
          description: Gone - Image media for this resource could not be found

  /images/{id}/filters/ae:
    post:
      tags: [Filters]
      summary: Apply AE Filter
      operationId: filterAE
      description: |
        Applies the AE Filter to the specified image resource and returns the filtered image.
      parameters:
        - name: id
          in: path
          description: Id of the image resource to process
          required: true
          schema:
            type: string
            format: text
      requestBody:
          description: The parameters used to process the image
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AEFilter'
      responses:
        '200':
          description: Success
          content:
            image/png:
              schema:
                type: string
                format: binary
        '400':
          description: Supplied filter contains invalid parameters
        '404':
          description: Image resource not found
        '410':
          description: Gone - Image media for this resource could not be found

components:
  schemas:
    ImageResource:
      description: Represents an image resource uploaded for processing.
      type: object
      properties:
        id:
          description: The resource id associated with the image
          type: string
          example: 160c98f9-d188-4118-94c4-697161fd5caf
        mediaType:
          description: The media type describing the format of the image data.
          type: string
          example: "image/png"
        url:
          description: The Url where the image media resource can be downloaded.
          type: string
          example: "https://example.com/images/160c98f9-d188-4118-94c4-697161fd5caf/file.png"
        createdOn:
          description: Timestamp indicating the time that the resource was created.
          type: string
          format: date-time
          example: 2021-05-03T10:56:00:00-04:00
        expires:
          description: Timestamp indicating the time that the resource will automatically expire and be deleted.
          type: string
          format: date-time
          example: 2021-05-03T18:56:00:00-04:00
        imageInfo:
          $ref: '#/components/schemas/ImageInfo'
        modalitySession:
          description: |
            Optional object that when present indicates that the resource belongs to a session created with the Modality API.
          allOf:
            - $ref: '#/components/schemas/ModalitySession'

    ModalitySession:
      description: Describes a resource from a current Modality session
      type: object
      properties:
        sessionId:
          description: Id of modality session
          type: string
          example: 451f7e06-5827-4c99-b6fb-b9c330ca922c
        imageId:
          description: Id of the image acquired by modality
          type: string
          example: 39db323b-198d-4219-b79e-ca918cde5be5

    ImageInfo:
      description: |
        Describes information about the image used to create an `ImageResource`. This information should be obtained directly from the corresponding `ImageInfo` object of the image acquired using the DSIO Modality API. Note that this object is a subset of the DSIO Modality API, thus allowing API consumers to use the same object for both.

      type: object
      properties:
        acquisitionInfo:
          description: Describes information regarding the acquisition from the DSIO Modality API.
          type: object
          properties:
            binning:
              description: |
                The binning mode used to acquire the image. When binning mode is set to Binned2x2, the sensor combines 4 pixels in a 2x2 neighborhood to create a single pixel. The resulting image is 1/4th the size of an Unbinned image, but with lower resolution. Note that some sensors may not support binning, in which case the binning property cannot be changed.
              type: string
              enum: [Unbinned, Binned2x2]
              example: Unbinned
        lutInfo:
          description: |
            Describes the lookup table (LUT) mapping applied to an image. This information should be obtained from the ImageInfo of the image that was acquired using the DSIO Modality API.

          type: object
          properties:
            gamma:
              description: Gamma value used in map
              type: number
              format: double
              example: 2.3
            slope:
              description: Slope value used in map
              type: number
              format: double
              example: 65535.0
            offset:
              description: Offset value used in map
              type: number
              format: double
              example: 0.0
            totalGrays:
              description: Total number of gray values in original (unmapped) image
              type: number
              format: integer
              example: 4096
            minimumGray:
              description: Minimum gray value in original (unmapped) image
              type: number
              format: integer
              example: 3612
            maximumGray:
              description: Maximum gray value in original (unmapped) image
              type: number
              format: integer
              example: 418

    SelectFilter:
      description: |
        Parameters used to apply the Select filter. This filter is optimized for images acquired from Xios XG Select and Schick Elite sensors.
      type: object
      properties:
        enhancementMode:
          description: The Select enhancement mode
          type: string
          enum:
            - smooth
            - edgeLow
            - edgeHigh
            - edgePro
          example: edgePro

    SupremeFilter:
      description: |
        Parameters used to apply the Supreme filter. This filter is optimized for images acquired from Xios XG Supreme and Schick 33 sensors.
      type: object
      properties:
        task:
          description: The task associated with the filter
          type: string
          enum:
            - general
            - endodontic
            - periodontic
            - restorative
            - hygiene
          example: general
        sharpness:
          description: The sharpness to apply to the image expressed as a percentage in the range 0-100.
          type: number
          format: float
          minimum: 0
          maximum: 100
          example: 70.0

    AEFilter:
      description: |
        Parameters used to apply the AE filter. This filter is optimized for images acquired from Xios AE and Schick AE sensors.
      type: object
      properties:
        task:
          description: The task associated with the filter
          type: string
          enum:
            - general
            - endodontic
            - periodontic
            - restorative
          example: general
        sharpness:
          description: The sharpness to apply to the image expressed as a percentage in the range 0-100.
          type: number
          format: float
          minimum: 0
          maximum: 100
          example: 70.0