Advanced API
2.2.11

Base URL
http://localhost:1888/v2/api

This is the API documentation for the NINA plugin Advanced API. Please use streaming instead of the default base64 encoding for images, as base64 support will be removed in the near future!

This is version 2.2.11 of this API documentation. Last update on Nov 7, 2025.

Application

Version

GET /version

Returns the installed plugin version.

Responses

  • 200 application/json

    Successful response

    Hide response attributes Show response attributes object
    • Response string
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
GET /version
curl \
 --request GET 'http://localhost:1888/v2/api/version'
Response examples (200)
{
  "Response": "2.2.11.0",
  "Error": "string",
  "StatusCode": 200,
  "Success": true,
  "Type": "API"
}

NINA Version

GET /version/nina

Returns the version of NINA.

Query parameters

  • friendly boolean

    If true, the version will be returned in a friendly format.

Responses

  • 200 application/json

    Successful response

    Hide response attributes Show response attributes object
    • Response string
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
GET /version/nina
curl \
 --request GET 'http://localhost:1888/v2/api/version/nina'
Response examples (200)
{
  "Response": {
    "oneOf": [
      "3.2.0.1058",
      "3.2 NIGHTLY #058"
    ]
  },
  "Error": "string",
  "StatusCode": 200,
  "Success": true,
  "Type": "API"
}

NINA start time

GET /application-start

Returns the time NINA was started.

Responses

  • 200 application/json

    Successful response

    Hide response attributes Show response attributes object
    • Response string
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
GET /application-start
curl \
 --request GET 'http://localhost:1888/v2/api/application-start'
Response examples (200)
{
  "Response": "2025-07-20T09:43:44+02:00",
  "Error": "string",
  "StatusCode": 200,
  "Success": true,
  "Type": "API"
}

Switch Tab

GET /application/switch-tab

Switches the application tab

Query parameters

  • tab string Required

    The tab to switch to

    Values are equipment, skyatlas, framing, flatwizard, sequencer, imaging, or options.

Responses

  • 200 application/json

    Successful response

    Hide response attributes Show response attributes object
    • Response string
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
  • 400 application/json

    Invalid application tab

    Hide response attributes Show response attributes object
    • Response string
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
  • 500 application/json

    Internal server error, Unknown error

    Hide response attributes Show response attributes object
    • Response string
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
GET /application/switch-tab
curl \
 --request GET 'http://localhost:1888/v2/api/application/switch-tab?tab=equipment'
Response examples (200)
{
  "Response": "Switched tab",
  "Error": "string",
  "StatusCode": 200,
  "Success": true,
  "Type": "API"
}
Response examples (400)
{
  "Response": "string",
  "Error": "Invalid application tab",
  "StatusCode": 400,
  "Success": false,
  "Type": "API"
}
Response examples (500)
{
  "Response": "string",
  "Error": "Unknown error",
  "StatusCode": 500,
  "Success": false,
  "Type": "API"
}

Get Tab

GET /application/get-tab

Gets the current application tab

Responses

  • 200 application/json

    Successful response

    Hide response attributes Show response attributes object
    • Response string

      Values are equipment, skyatlas, framing, flatwizard, sequencer, imaging, or options.

    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
  • 400 application/json

    Invalid application tab

    Hide response attributes Show response attributes object
    • Response string
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
  • 500 application/json

    Internal server error, Unknown error

    Hide response attributes Show response attributes object
    • Response string
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
GET /application/get-tab
curl \
 --request GET 'http://localhost:1888/v2/api/application/get-tab'
Response examples (200)
{
  "Response": "equipment",
  "Error": "string",
  "StatusCode": 200,
  "Success": true,
  "Type": "API"
}
Response examples (400)
{
  "Response": "string",
  "Error": "Invalid application tab",
  "StatusCode": 400,
  "Success": false,
  "Type": "API"
}
Response examples (500)
{
  "Response": "string",
  "Error": "Unknown error",
  "StatusCode": 500,
  "Success": false,
  "Type": "API"
}

Plugins

GET /application/plugins

Get a list of installed plugins. This is useful for example if you want to use an integrated plugin like livestack or TPPA

Responses

  • 200 application/json

    Successful response

    Hide response attributes Show response attributes object
    • Response array(string)
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
  • 500 application/json

    Internal server error, Unknown error

    Hide response attributes Show response attributes object
    • Response string
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
GET /application/plugins
curl \
 --request GET 'http://localhost:1888/v2/api/application/plugins'
Response examples (200)
{
  "Response": [
    "Advanced API",
    "Livestack",
    "Three Point Polar Alignment",
    "Touch 'N' Stars"
  ],
  "Error": "string",
  "StatusCode": 200,
  "Success": true,
  "Type": "API"
}
Response examples (500)
{
  "Response": "string",
  "Error": "Unknown error",
  "StatusCode": 500,
  "Success": false,
  "Type": "API"
}

Logs

GET /application/logs

Get a list of the last N log entries, this will ignore the header of the file. The endpoint is limited by the log level set in NINA

Query parameters

  • lineCount integer(int32) Required

    Return the last N lines of the log file, with N being the lineCount

  • level string

    Filter the log entries by level. This uses the provided level as a minimum level, so level INFO will return INFO, WARNING and ERROR entries

    Values are TRACE, DEBUG, INFO, WARNING, or ERROR.

Responses

  • 200 application/json

    Successful response

    Hide response attributes Show response attributes object
    • Response array[object]
      Hide Response attributes Show Response attributes object
      • Timestamp string
      • Level string
      • Source string
      • Member string
      • Line string
      • Message string
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
  • 500 application/json

    Internal server error, Unknown error

    Hide response attributes Show response attributes object
    • Response string
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
GET /application/logs
curl \
 --request GET 'http://localhost:1888/v2/api/application/logs?lineCount=42'
Response examples (200)
{
  "Response": [
    {
      "Timestamp": "2025-05-04T14:57:39.5079",
      "Level": "INFO",
      "Source": "CameraChooserVM.cs",
      "Member": "GetEquipment",
      "Line": "279",
      "Message": "Found 2 ASCOM Cameras"
    }
  ],
  "Error": "string",
  "StatusCode": 200,
  "Success": true,
  "Type": "API"
}
Response examples (500)
{
  "Response": "string",
  "Error": "Unknown error",
  "StatusCode": 500,
  "Success": false,
  "Type": "API"
}

Screenshot

GET /application/screenshot

Takes a screenshot

Query parameters

  • resize boolean

    Whether to resize the screenshot.

  • quality integer(int32)

    The quality of the screenshot, ranging from 1 (worst) to 100 (best). -1 or omitted for png

  • size string

    The size of the screenshot ([width]x[height]). Requires resize to be true.

  • scale number(double)

    The scale of the screenshot. Requires resize to be true.

  • stream boolean

    Stream the image to the client. This will stream the image in image/jpg or image/png format.

Responses

  • Successful response

    Hide response attributes Show response attributes object
    • Response string
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
  • 500 application/json

    Internal server error, Unknown error

    Hide response attributes Show response attributes object
    • Response string
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
GET /application/screenshot
curl \
 --request GET 'http://localhost:1888/v2/api/application/screenshot'
Response examples (200)
{
  "Response": "<base64 encoded image>",
  "Error": "string",
  "StatusCode": 200,
  "Success": true,
  "Type": "API"
}
Response examples (500)
{
  "Response": "string",
  "Error": "Unknown error",
  "StatusCode": 500,
  "Success": false,
  "Type": "API"
}

Camera

Information

GET /equipment/camera/info

This endpoint returns relevant information about the camera.

Responses

  • 200 application/json

    Successful response

    Hide response attributes Show response attributes object
    • Response object Required
      Hide Response attributes Show Response attributes object
      • TargetTemp number
      • AtTargetTemp boolean
      • CanSetTemperature boolean
      • HasShutter boolean
      • Temperature number
      • Gain integer
      • DefaultGain integer
      • ElectronsPerADU number
      • BinX integer
      • BitDepth integer
      • BinY integer
      • CanSetOffset boolean
      • CanGetGain boolean
      • OffsetMin integer
      • OffsetMax integer
      • Offset integer
      • DefaultOffset integer
      • USBLimit integer
      • IsSubSampleEnabled boolean
      • CameraState string

        Values are NoState, Idle, Waiting, Exposing, Reading, Download, Error, or LoadingFile.

      • XSize integer
      • YSize integer
      • PixelSize number
      • Battery integer
      • GainMin integer
      • GainMax integer
      • CanSetGain boolean
      • Gains array
      • CoolerOn boolean
      • CoolerPower number
      • HasDewHeater boolean
      • DewHeaterOn boolean
      • CanSubSample boolean
      • SubSampleX integer
      • SubSampleY integer
      • SubSampleWidth integer
      • SubSampleHeight integer
      • TemperatureSetPoint number
      • ReadoutModes array[string]
      • ReadoutMode integer
      • ReadoutModeForSnapImages integer
      • ReadoutModeForNormalImages integer
      • IsExposing boolean
      • ExposureEndTime string
      • LastDownloadTime number
      • SensorType string

        Values are Monochrome, Color, RGGB, CMYG, CMYG2, LRGB, BGGR, GBRG, GRBG, GRGB, GBGR, RGBG, or BGRG.

      • BayerOffsetX integer
      • BayerOffsetY integer
      • BinningModes array[object]
        Hide BinningModes attributes Show BinningModes attributes object
        • Name string Required
        • X integer Required
        • Y integer Required
      • ExposureMax number
      • ExposureMin number
      • LiveViewEnabled boolean
      • CanShowLiveView boolean
      • SupportedActions array[string]
      • CanSetUSBLimit boolean
      • USBLimitMin integer
      • USBLimitMax integer
      • Connected boolean
      • Name string
      • DisplayName string
      • DeviceId string
    • Error string Required
    • StatusCode integer Required
    • Success boolean Required
    • Type string Required
  • 500 application/json

    Internal server error, Unknown error

    Hide response attributes Show response attributes object
    • Response string
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
GET /equipment/camera/info
curl \
 --request GET 'http://localhost:1888/v2/api/equipment/camera/info'
Response examples (200)
{
  "Response": {
    "TargetTemp": 42.0,
    "AtTargetTemp": true,
    "CanSetTemperature": true,
    "HasShutter": true,
    "Temperature": 42.0,
    "Gain": 42,
    "DefaultGain": 42,
    "ElectronsPerADU": 42.0,
    "BinX": 42,
    "BitDepth": 42,
    "BinY": 42,
    "CanSetOffset": true,
    "CanGetGain": true,
    "OffsetMin": 42,
    "OffsetMax": 42,
    "Offset": 42,
    "DefaultOffset": 42,
    "USBLimit": 42,
    "IsSubSampleEnabled": true,
    "CameraState": "NoState",
    "XSize": 42,
    "YSize": 42,
    "PixelSize": 42.0,
    "Battery": 42,
    "GainMin": 42,
    "GainMax": 42,
    "CanSetGain": true,
    "Gains": [],
    "CoolerOn": true,
    "CoolerPower": 42.0,
    "HasDewHeater": true,
    "DewHeaterOn": true,
    "CanSubSample": true,
    "SubSampleX": 42,
    "SubSampleY": 42,
    "SubSampleWidth": 42,
    "SubSampleHeight": 42,
    "TemperatureSetPoint": 42.0,
    "ReadoutModes": [
      "string"
    ],
    "ReadoutMode": 42,
    "ReadoutModeForSnapImages": 42,
    "ReadoutModeForNormalImages": 42,
    "IsExposing": true,
    "ExposureEndTime": "string",
    "LastDownloadTime": 42.0,
    "SensorType": "Monochrome",
    "BayerOffsetX": 42,
    "BayerOffsetY": 42,
    "BinningModes": [
      {
        "Name": "string",
        "X": 42,
        "Y": 42
      }
    ],
    "ExposureMax": 42.0,
    "ExposureMin": 42.0,
    "LiveViewEnabled": true,
    "CanShowLiveView": true,
    "SupportedActions": [
      "string"
    ],
    "CanSetUSBLimit": true,
    "USBLimitMin": 42,
    "USBLimitMax": 42,
    "Connected": true,
    "Name": "string",
    "DisplayName": "string",
    "DeviceId": "string"
  },
  "Error": "string",
  "StatusCode": 42,
  "Success": true,
  "Type": "string"
}
Response examples (500)
{
  "Response": "string",
  "Error": "Unknown error",
  "StatusCode": 500,
  "Success": false,
  "Type": "API"
}

Connect

GET /equipment/camera/connect

Connect to Camera

Query parameters

  • to string

    The Id of the device that should be connected.

Responses

  • 200 application/json

    Successful response

    Hide response attributes Show response attributes object
    • Response string
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
  • 500 application/json

    Internal server error, Unknown error

    Hide response attributes Show response attributes object
    • Response string
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
GET /equipment/camera/connect
curl \
 --request GET 'http://localhost:1888/v2/api/equipment/camera/connect'
Response examples (200)
{
  "Response": "Connected",
  "Error": "string",
  "StatusCode": 200,
  "Success": true,
  "Type": "API"
}
Response examples (500)
{
  "Response": "string",
  "Error": "Unknown error",
  "StatusCode": 500,
  "Success": false,
  "Type": "API"
}

Disconnect

GET /equipment/camera/disconnect

This endpoint disconnects the camera.

Responses

  • 200 application/json

    Successful response

    Hide response attributes Show response attributes object
    • Response string
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
  • 500 application/json

    Internal server error, Unknown error

    Hide response attributes Show response attributes object
    • Response string
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
GET /equipment/camera/disconnect
curl \
 --request GET 'http://localhost:1888/v2/api/equipment/camera/disconnect'
Response examples (200)
{
  "Response": "Disconnected",
  "Error": "string",
  "StatusCode": 200,
  "Success": true,
  "Type": "API"
}
Response examples (500)
{
  "Response": "string",
  "Error": "Unknown error",
  "StatusCode": 500,
  "Success": false,
  "Type": "API"
}

List Devices

GET /equipment/camera/list-devices

List all devices which can be connected

Responses

  • 200 application/json

    Successful response

    Hide response attributes Show response attributes object
    • Response array[object]
      Hide Response attributes Show Response attributes object
      • HasSetupDialog boolean
      • Id string
      • Name string
      • DisplayName string
      • Category string
      • Connected boolean
      • Description string
      • DriverInfo string
      • DriverVersion string
      • SupportedActions array
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
  • 500 application/json

    Internal server error, Unknown error

    Hide response attributes Show response attributes object
    • Response string
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
GET /equipment/camera/list-devices
curl \
 --request GET 'http://localhost:1888/v2/api/equipment/camera/list-devices'
Response examples (200)
{
  "Response": [
    {
      "HasSetupDialog": true,
      "Id": "string",
      "Name": "string",
      "DisplayName": "string",
      "Category": "string",
      "Connected": true,
      "Description": "string",
      "DriverInfo": "string",
      "DriverVersion": "string",
      "SupportedActions": []
    }
  ],
  "Error": "string",
  "StatusCode": 200,
  "Success": true,
  "Type": "API"
}
Response examples (500)
{
  "Response": "string",
  "Error": "Unknown error",
  "StatusCode": 500,
  "Success": false,
  "Type": "API"
}

Rescan Devices

GET /equipment/camera/rescan

Rescans for new devices, and returns a list of all available devices

Responses

  • 200 application/json

    Successful response

    Hide response attributes Show response attributes object
    • Response array[object]
      Hide Response attributes Show Response attributes object
      • HasSetupDialog boolean
      • Id string
      • Name string
      • DisplayName string
      • Category string
      • Connected boolean
      • Description string
      • DriverInfo string
      • DriverVersion string
      • SupportedActions array
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
  • 500 application/json

    Internal server error, Unknown error

    Hide response attributes Show response attributes object
    • Response string
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
GET /equipment/camera/rescan
curl \
 --request GET 'http://localhost:1888/v2/api/equipment/camera/rescan'
Response examples (200)
{
  "Response": [
    {
      "HasSetupDialog": true,
      "Id": "string",
      "Name": "string",
      "DisplayName": "string",
      "Category": "string",
      "Connected": true,
      "Description": "string",
      "DriverInfo": "string",
      "DriverVersion": "string",
      "SupportedActions": []
    }
  ],
  "Error": "string",
  "StatusCode": 200,
  "Success": true,
  "Type": "API"
}
Response examples (500)
{
  "Response": "string",
  "Error": "Unknown error",
  "StatusCode": 500,
  "Success": false,
  "Type": "API"
}

Set readout mode

GET /equipment/camera/set-readout

This endpoint sets the readout mode of the camera.

Query parameters

  • mode integer Required

    The readout mode to set.

    Minimum value is 0.

Responses

  • 200 application/json

    Successful response

    Hide response attributes Show response attributes object
    • Response string
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
  • 400 application/json

    Invalid readout mode

    Hide response attributes Show response attributes object
    • Response string
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
  • 500 application/json

    Internal Server Error

    Hide response attributes Show response attributes object
    • Response string
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
GET /equipment/camera/set-readout
curl \
 --request GET 'http://localhost:1888/v2/api/equipment/camera/set-readout?mode=42'
Response examples (200)
{
  "Response": "Readout mode updated",
  "Error": "string",
  "StatusCode": 200,
  "Success": true,
  "Type": "API"
}
Response examples (400)
{
  "Response": "string",
  "Error": "Invalid readout mode",
  "StatusCode": 409,
  "Success": false,
  "Type": "API"
}
Response examples (500)
{
  "Response": "string",
  "Error": "Unknown error",
  "StatusCode": 500,
  "Success": false,
  "Type": "API"
}

Cooling

GET /equipment/camera/cool

This endpoint cools the camera.

Query parameters

  • temperature number(double) Required

    The temperature to cool the camera to.

  • minutes number(double) Required

    The minimum duration to cool the camera. -1 for default duration

  • cancel boolean

    Whether to cancel the cooling process.

Responses

  • 200 application/json

    Successful response

    Hide response attributes Show response attributes object
    • Response string

      Values are Cooling started or Cooling canceled.

    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
  • 409 application/json

    Camera not connected / Camera has no temperature control

    Hide response attributes Show response attributes object
    • Response string
    • Error string

      Values are Camera not connected or Camera has no temperature control.

    • StatusCode integer
    • Success boolean
    • Type string
  • 500 application/json

    Internal server error, Unknown error

    Hide response attributes Show response attributes object
    • Response string
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
GET /equipment/camera/cool
curl \
 --request GET 'http://localhost:1888/v2/api/equipment/camera/cool?temperature=42.0&minutes=42.0'
Response examples (200)
{
  "Response": "Cooling started",
  "Error": "string",
  "StatusCode": 200,
  "Success": true,
  "Type": "API"
}
Response examples (409)
{
  "Response": "string",
  "Error": "Camera not connected",
  "StatusCode": 409,
  "Success": false,
  "Type": "API"
}
Response examples (500)
{
  "Response": "string",
  "Error": "Unknown error",
  "StatusCode": 500,
  "Success": false,
  "Type": "API"
}

Warming

GET /equipment/camera/warm

This endpoint warms the camera.

Query parameters

  • minutes number(double) Required

    The minimum duration to warm the camera. -1 for default duration

  • cancel boolean

    Whether to cancel the warming process.

Responses

  • 200 application/json

    Successful response

    Hide response attributes Show response attributes object
    • Response string

      Values are Warming started or Warming canceled.

    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
  • 409 application/json

    Camera not connected / Camera has no temperature control

    Hide response attributes Show response attributes object
    • Response string
    • Error string

      Values are Camera not connected or Camera has no temperature control.

    • StatusCode integer
    • Success boolean
    • Type string
  • 500 application/json

    Internal server error, Unknown error

    Hide response attributes Show response attributes object
    • Response string
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
GET /equipment/camera/warm
curl \
 --request GET 'http://localhost:1888/v2/api/equipment/camera/warm?minutes=42.0'
Response examples (200)
{
  "Response": "Warming started",
  "Error": "string",
  "StatusCode": 200,
  "Success": true,
  "Type": "API"
}
Response examples (409)
{
  "Response": "string",
  "Error": "Camera not connected",
  "StatusCode": 409,
  "Success": false,
  "Type": "API"
}
Response examples (500)
{
  "Response": "string",
  "Error": "Unknown error",
  "StatusCode": 500,
  "Success": false,
  "Type": "API"
}

Exposure Abort

GET /equipment/camera/abort-exposure

This endpoint aborts the current exposure.

Responses

  • 200 application/json

    Successful response

    Hide response attributes Show response attributes object
    • Response string

      Values are Exposure aborted or Camera not exposing.

    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
  • 409 application/json

    Camera not connected / Camera not exposing

    Hide response attributes Show response attributes object
    • Response string
    • Error string

      Values are Camera not connected or Camera not exposing.

    • StatusCode integer
    • Success boolean
    • Type string
  • 500 application/json

    Internal server error, Unknown error

    Hide response attributes Show response attributes object
    • Response string
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
GET /equipment/camera/abort-exposure
curl \
 --request GET 'http://localhost:1888/v2/api/equipment/camera/abort-exposure'
Response examples (200)
{
  "Response": "Exposure aborted",
  "Error": "string",
  "StatusCode": 200,
  "Success": true,
  "Type": "API"
}
Response examples (409)
{
  "Response": "string",
  "Error": "Camera not connected",
  "StatusCode": 409,
  "Success": false,
  "Type": "API"
}
Response examples (500)
{
  "Response": "string",
  "Error": "Unknown error",
  "StatusCode": 500,
  "Success": false,
  "Type": "API"
}

Dew Heater Control

GET /equipment/camera/dew-heater

This endpoint sets the dew heater.

Query parameters

  • power boolean Required

    Whether to turn the dew heater on or off.

Responses

  • 200 application/json

    Successful response

    Hide response attributes Show response attributes object
    • Response string
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
  • 409 application/json

    Camera not connected / Camera has no dew heater

    Hide response attributes Show response attributes object
    • Response string
    • Error string

      Values are Camera not connected or Camera has no dew heater.

    • StatusCode integer
    • Success boolean
    • Type string
  • 500 application/json

    Internal server error, Unknown error

    Hide response attributes Show response attributes object
    • Response string
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
GET /equipment/camera/dew-heater
curl \
 --request GET 'http://localhost:1888/v2/api/equipment/camera/dew-heater?power=true'
Response examples (200)
{
  "Response": "Dew heater set",
  "Error": "string",
  "StatusCode": 200,
  "Success": true,
  "Type": "API"
}
Response examples (409)
{
  "Response": "string",
  "Error": "Camera not connected",
  "StatusCode": 409,
  "Success": false,
  "Type": "API"
}
Response examples (500)
{
  "Response": "string",
  "Error": "Unknown error",
  "StatusCode": 500,
  "Success": false,
  "Type": "API"
}

Set Binning

GET /equipment/camera/set-binning

This endpoint sets the binning of the camera, if the specified binning is supported

Query parameters

  • binning string Required

    The binning mode

Responses

  • 200 application/json

    Successful response

    Hide response attributes Show response attributes object
    • Response string
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
  • 409 application/json

    Camera not connected / Invalid binning mode

    Hide response attributes Show response attributes object
    • Response string
    • Error string

      Values are Camera not connected, Invalid binning mode, or Binning must be specified.

    • StatusCode integer
    • Success boolean
    • Type string
  • 500 application/json

    Internal server error, Unknown error

    Hide response attributes Show response attributes object
    • Response string
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
GET /equipment/camera/set-binning
curl \
 --request GET 'http://localhost:1888/v2/api/equipment/camera/set-binning?binning=2x2'
Response examples (200)
{
  "Response": "Binning set",
  "Error": "string",
  "StatusCode": 200,
  "Success": true,
  "Type": "API"
}
Response examples (409)
{
  "Response": "string",
  "Error": "Camera not connected",
  "StatusCode": 409,
  "Success": false,
  "Type": "API"
}
Response examples (500)
{
  "Response": "string",
  "Error": "Unknown error",
  "StatusCode": 500,
  "Success": false,
  "Type": "API"
}

Capture / Platesolve

GET /equipment/camera/capture

This endpoint captures and/or returns an image. Can optionally solve the image.

Query parameters

  • solve boolean

    Whether to solve the image.

  • duration number(double)

    The duration of the exposure. If omitted the exposure time for plate solving will be used.

  • gain number(int32)

    The gain to use for the exposure. If omitted, the camera's default gain will be used.

  • getResult boolean

    Whether to get the result.

  • resize boolean

    Whether to resize the image.

  • quality number(int32)

    The quality of the image, ranging from 1 (worst) to 100 (best). -1 or omitted for png

  • size string

    The size of the image ([width]x[height]). Requires resize to be true.

  • scale number(double)

    The scale of the image. Requires resize to be true.

  • stream boolean

    Stream the image to the client. This will only stream the image in image/jpg or image/png format. The platesolve result is not included.

  • omitImage boolean

    Omit the image from the response. This will only send the platesolve result, if the image was platesolved. Use it if you do not care about the image, only about the platesolve result.

  • waitForResult boolean

    Wait for the capture to finish and then return the result. This will immediately take into account all the settings you would otherwise use together with getResult, like resize and stream.

  • targetName string

    The name of the target that is being captured. Useful for livestacking as an example.

  • save boolean

    Save the image to the disk. This needs to be set, when capturing the image.

  • onlyAwaitCaptureCompletion boolean

    Use this if you want to capture images at a high rate, the endpoint will return immediately once the camera is ready to take a picture again. The image preparation, platesolve and save will continue to run in the background, so the image wont be available until these have completed as well.

  • onlySaveRaw boolean

    Use if you do not need the other capture endpoints, but want to save the raw image. Useful for high frequency captures.

Responses

  • Successful response

    Hide response attributes Show response attributes object
    • Response string | object

      One of:

      Values are Capture already in progress or Capture started.

    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
  • 409 application/json

    Camera not connected / Camera currently exposing

    Hide response attributes Show response attributes object
    • Response string

      Values are Camera not connected or Camera currently exposing.

    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
  • 500 application/json

    Internal server error, Unknown error

    Hide response attributes Show response attributes object
    • Response string
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
GET /equipment/camera/capture
curl \
 --request GET 'http://localhost:1888/v2/api/equipment/camera/capture'
Response examples (200)
{
  "Response": "Capture already in progress",
  "Error": "string",
  "StatusCode": 200,
  "Success": true,
  "Type": "API"
}
Response examples (409)
{
  "Response": "Camera not connected",
  "Error": "string",
  "StatusCode": 409,
  "Success": false,
  "Type": "API"
}
Response examples (500)
{
  "Response": "string",
  "Error": "Unknown error",
  "StatusCode": 500,
  "Success": false,
  "Type": "API"
}

Capture Statistics

GET /equipment/camera/capture/statistics

This endpoint returns the image statistics for the last captured image.

Responses

  • 200 application/json

    Successful response

    Hide response attributes Show response attributes object
    • Response object
      Hide Response attributes Show Response attributes object
      • Stars integer
      • HFR number
      • Median number
      • MedianAbsoluteDeviation number
      • Mean number
      • Max integer
      • Min integer
      • StDev number
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
  • 400 application/json

    Capture not available

    Hide response attributes Show response attributes object
    • Response string
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
  • 500 application/json

    Internal server error, Unknown error

    Hide response attributes Show response attributes object
    • Response string
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
GET /equipment/camera/capture/statistics
curl \
 --request GET 'http://localhost:1888/v2/api/equipment/camera/capture/statistics'
Response examples (200)
{
  "Response": {
    "Stars": 42,
    "HFR": 42.0,
    "Median": 42.0,
    "MedianAbsoluteDeviation": 42.0,
    "Mean": 42.0,
    "Max": 42,
    "Min": 42,
    "StDev": 42.0
  },
  "Error": "string",
  "StatusCode": 42,
  "Success": true,
  "Type": "string"
}
Response examples (400)
{
  "Response": "No image available",
  "Error": "string",
  "StatusCode": 409,
  "Success": false,
  "Type": "API"
}
Response examples (500)
{
  "Response": "string",
  "Error": "Unknown error",
  "StatusCode": 500,
  "Success": false,
  "Type": "API"
}

Dome

Information

GET /equipment/dome/info

Get Dome information

Responses

  • 200 application/json

    Successful response

    Hide response attributes Show response attributes object
    • Response object Required
      Hide Response attributes Show Response attributes object
      • ShutterStatus string

        Values are ShutterNone, ShutterOpen, ShutterClosed, ShutterOpening, ShutterClosing, or ShutterError.

      • DriverCanFollow boolean
      • CanSetShutter boolean
      • CanSetPark boolean
      • CanSetAzimuth boolean
      • CanSyncAzimuth boolean
      • CanPark boolean
      • CanFindHome boolean
      • AtPark boolean
      • AtHome boolean
      • DriverFollowing boolean
      • Slewing boolean
      • Azimuth integer
      • SupportedActions array
      • Connected boolean
      • Name string
      • DisplayName string
      • Description string
      • DriverInfo string
      • DriverVersion string
      • DeviceId string
      • IsFollowing boolean
      • IsSynchronized boolean
    • Error string Required
    • StatusCode integer Required
    • Success boolean Required
    • Type string Required
  • 500 application/json

    Internal server error, Unknown error

    Hide response attributes Show response attributes object
    • Response string
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
GET /equipment/dome/info
curl \
 --request GET 'http://localhost:1888/v2/api/equipment/dome/info'
Response examples (200)
{
  "Response": {
    "ShutterStatus": "ShutterNone",
    "DriverCanFollow": true,
    "CanSetShutter": true,
    "CanSetPark": true,
    "CanSetAzimuth": true,
    "CanSyncAzimuth": true,
    "CanPark": true,
    "CanFindHome": true,
    "AtPark": true,
    "AtHome": true,
    "DriverFollowing": true,
    "Slewing": true,
    "Azimuth": 42,
    "SupportedActions": [],
    "Connected": true,
    "Name": "string",
    "DisplayName": "string",
    "Description": "string",
    "DriverInfo": "string",
    "DriverVersion": "string",
    "DeviceId": "string",
    "IsFollowing": true,
    "IsSynchronized": true
  },
  "Error": "string",
  "StatusCode": 42,
  "Success": true,
  "Type": "string"
}
Response examples (500)
{
  "Response": "string",
  "Error": "Unknown error",
  "StatusCode": 500,
  "Success": false,
  "Type": "API"
}

Connect

GET /equipment/dome/connect

Connect to Dome

Query parameters

  • to string

    The Id of the device that should be connected.

Responses

  • 200 application/json

    Successful response

    Hide response attributes Show response attributes object
    • Response string
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
  • 500 application/json

    Internal server error, Unknown error

    Hide response attributes Show response attributes object
    • Response string
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
GET /equipment/dome/connect
curl \
 --request GET 'http://localhost:1888/v2/api/equipment/dome/connect'
Response examples (200)
{
  "Response": "Connected",
  "Error": "string",
  "StatusCode": 200,
  "Success": true,
  "Type": "API"
}
Response examples (500)
{
  "Response": "string",
  "Error": "Unknown error",
  "StatusCode": 500,
  "Success": false,
  "Type": "API"
}

Disconnect

GET /equipment/dome/disconnect

Disconnect the Dome

Responses

  • 200 application/json

    Successful response

    Hide response attributes Show response attributes object
    • Response string
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
  • 500 application/json

    Internal server error, Unknown error

    Hide response attributes Show response attributes object
    • Response string
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
GET /equipment/dome/disconnect
curl \
 --request GET 'http://localhost:1888/v2/api/equipment/dome/disconnect'
Response examples (200)
{
  "Response": "Disconnected",
  "Error": "string",
  "StatusCode": 200,
  "Success": true,
  "Type": "API"
}
Response examples (500)
{
  "Response": "string",
  "Error": "Unknown error",
  "StatusCode": 500,
  "Success": false,
  "Type": "API"
}

List Devices

GET /equipment/dome/list-devices

List all devices which can be connected

Responses

  • 200 application/json

    Successful response

    Hide response attributes Show response attributes object
    • Response array[object]
      Hide Response attributes Show Response attributes object
      • HasSetupDialog boolean
      • Id string
      • Name string
      • DisplayName string
      • Category string
      • Connected boolean
      • Description string
      • DriverInfo string
      • DriverVersion string
      • SupportedActions array
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
  • 500 application/json

    Internal server error, Unknown error

    Hide response attributes Show response attributes object
    • Response string
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
GET /equipment/dome/list-devices
curl \
 --request GET 'http://localhost:1888/v2/api/equipment/dome/list-devices'
Response examples (200)
{
  "Response": [
    {
      "HasSetupDialog": true,
      "Id": "string",
      "Name": "string",
      "DisplayName": "string",
      "Category": "string",
      "Connected": true,
      "Description": "string",
      "DriverInfo": "string",
      "DriverVersion": "string",
      "SupportedActions": []
    }
  ],
  "Error": "string",
  "StatusCode": 200,
  "Success": true,
  "Type": "API"
}
Response examples (500)
{
  "Response": "string",
  "Error": "Unknown error",
  "StatusCode": 500,
  "Success": false,
  "Type": "API"
}

Rescan Devices

GET /equipment/dome/rescan

Rescans for new devices, and returns a list of all available devices

Responses

  • 200 application/json

    Successful response

    Hide response attributes Show response attributes object
    • Response array[object]
      Hide Response attributes Show Response attributes object
      • HasSetupDialog boolean
      • Id string
      • Name string
      • DisplayName string
      • Category string
      • Connected boolean
      • Description string
      • DriverInfo string
      • DriverVersion string
      • SupportedActions array
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
  • 500 application/json

    Internal server error, Unknown error

    Hide response attributes Show response attributes object
    • Response string
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
GET /equipment/dome/rescan
curl \
 --request GET 'http://localhost:1888/v2/api/equipment/dome/rescan'
Response examples (200)
{
  "Response": [
    {
      "HasSetupDialog": true,
      "Id": "string",
      "Name": "string",
      "DisplayName": "string",
      "Category": "string",
      "Connected": true,
      "Description": "string",
      "DriverInfo": "string",
      "DriverVersion": "string",
      "SupportedActions": []
    }
  ],
  "Error": "string",
  "StatusCode": 200,
  "Success": true,
  "Type": "API"
}
Response examples (500)
{
  "Response": "string",
  "Error": "Unknown error",
  "StatusCode": 500,
  "Success": false,
  "Type": "API"
}

Open Shutter

GET /equipment/dome/open

Open Dome Shutter

Responses

  • 200 application/json

    Successful response

    Hide response attributes Show response attributes object
    • Response string

      Values are Shutter opening or Shutter already open.

    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
  • 409 application/json

    Dome not connected

    Hide response attributes Show response attributes object
    • Response string
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
  • 500 application/json

    Internal server error, Unknown error

    Hide response attributes Show response attributes object
    • Response string
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
GET /equipment/dome/open
curl \
 --request GET 'http://localhost:1888/v2/api/equipment/dome/open'
Response examples (200)
{
  "Response": "Shutter opening",
  "Error": "string",
  "StatusCode": 200,
  "Success": true,
  "Type": "API"
}
Response examples (409)
{
  "Response": "string",
  "Error": "Dome not connected",
  "StatusCode": 409,
  "Success": false,
  "Type": "API"
}
Response examples (500)
{
  "Response": "string",
  "Error": "Unknown error",
  "StatusCode": 500,
  "Success": false,
  "Type": "API"
}

Close Shutter

GET /equipment/dome/close

Close Dome Shutter

Responses

  • 200 application/json

    Successful response

    Hide response attributes Show response attributes object
    • Response string

      Values are Shutter closing or Shutter already closed.

    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
  • 409 application/json

    Dome not connected

    Hide response attributes Show response attributes object
    • Response string
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
  • 500 application/json

    Internal server error, Unknown error

    Hide response attributes Show response attributes object
    • Response string
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
GET /equipment/dome/close
curl \
 --request GET 'http://localhost:1888/v2/api/equipment/dome/close'
Response examples (200)
{
  "Response": "Shutter closing",
  "Error": "string",
  "StatusCode": 200,
  "Success": true,
  "Type": "API"
}
Response examples (409)
{
  "Response": "string",
  "Error": "Dome not connected",
  "StatusCode": 409,
  "Success": false,
  "Type": "API"
}
Response examples (500)
{
  "Response": "string",
  "Error": "Unknown error",
  "StatusCode": 500,
  "Success": false,
  "Type": "API"
}

Stop Dome Movement

GET /equipment/dome/stop

Stop Dome movement.

Responses

  • 200 application/json

    Successful response

    Hide response attributes Show response attributes object
    • Response string
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
  • 409 application/json

    Dome not connected

    Hide response attributes Show response attributes object
    • Response string
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
  • 500 application/json

    Internal server error, Unknown error

    Hide response attributes Show response attributes object
    • Response string
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
GET /equipment/dome/stop
curl \
 --request GET 'http://localhost:1888/v2/api/equipment/dome/stop'
Response examples (200)
{
  "Response": "Movement stopped",
  "Error": "string",
  "StatusCode": 200,
  "Success": true,
  "Type": "API"
}
Response examples (409)
{
  "Response": "string",
  "Error": "Dome not connected",
  "StatusCode": 409,
  "Success": false,
  "Type": "API"
}
Response examples (500)
{
  "Response": "string",
  "Error": "Unknown error",
  "StatusCode": 500,
  "Success": false,
  "Type": "API"
}

Set Dome Follow

GET /equipment/dome/set-follow

Start or stop the dome to follow the telescope

Query parameters

  • enabled boolean

    Enable or disable dome follow

Responses

  • 200 application/json

    Successful response

    Hide response attributes Show response attributes object
    • Response string

      Values are Following enabled or Following disabled.

    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
  • 409 application/json

    Dome not connected

    Hide response attributes Show response attributes object
    • Response string
    • Error string

      Values are Dome not connected, Dome shutter not open, or Mount not connected.

    • StatusCode integer
    • Success boolean
    • Type string
  • 500 application/json

    Internal server error, Unknown error

    Hide response attributes Show response attributes object
    • Response string
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
GET /equipment/dome/set-follow
curl \
 --request GET 'http://localhost:1888/v2/api/equipment/dome/set-follow'
Response examples (200)
{
  "Response": "Following enabled",
  "Error": "string",
  "StatusCode": 200,
  "Success": true,
  "Type": "API"
}
Response examples (409)
{
  "Response": "string",
  "Error": "Dome not connected",
  "StatusCode": 409,
  "Success": false,
  "Type": "API"
}
Response examples (500)
{
  "Response": "string",
  "Error": "Unknown error",
  "StatusCode": 500,
  "Success": false,
  "Type": "API"
}

Sync Dome To Telescope

GET /equipment/dome/sync

Sync dome to telescope coordinates

Responses

  • 200 application/json

    Successful response

    Hide response attributes Show response attributes object
    • Response string
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
  • 409 application/json

    Dome not connected

    Hide response attributes Show response attributes object
    • Response string
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
  • 500 application/json

    Internal server error, Unknown error

    Hide response attributes Show response attributes object
    • Response string
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
GET /equipment/dome/sync
curl \
 --request GET 'http://localhost:1888/v2/api/equipment/dome/sync'
Response examples (200)
{
  "Response": "Dome Sync Started",
  "Error": "string",
  "StatusCode": 200,
  "Success": true,
  "Type": "API"
}
Response examples (409)
{
  "Response": "string",
  "Error": "Dome not connected",
  "StatusCode": 409,
  "Success": false,
  "Type": "API"
}
Response examples (500)
{
  "Response": "string",
  "Error": "Unknown error",
  "StatusCode": 500,
  "Success": false,
  "Type": "API"
}

Slew

GET /equipment/dome/slew

Slew dome to specified azimuth

Query parameters

  • azimuth number(float)

    Azimuth in degrees

  • waitToFinish boolean

    Wait until slew is finished

Responses

  • 200 application/json

    Successful response

    Hide response attributes Show response attributes object
    • Response string

      Values are Dome Slew Started or Dome Slew finished.

    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
  • 409 application/json

    Dome not connected / parked

    Hide response attributes Show response attributes object
    • Response string
    • Error string

      Values are Dome not connected or Dome is parked.

    • StatusCode integer
    • Success boolean
    • Type string
  • 500 application/json

    Internal server error, Unknown error

    Hide response attributes Show response attributes object
    • Response string
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
GET /equipment/dome/slew
curl \
 --request GET 'http://localhost:1888/v2/api/equipment/dome/slew'
Response examples (200)
{
  "Response": "Dome Slew Started",
  "Error": "string",
  "StatusCode": 200,
  "Success": true,
  "Type": "API"
}
Response examples (409)
{
  "Response": "string",
  "Error": "Dome not connected",
  "StatusCode": 409,
  "Success": false,
  "Type": "API"
}
Response examples (500)
{
  "Response": "string",
  "Error": "Unknown error",
  "StatusCode": 500,
  "Success": false,
  "Type": "API"
}

Set Park Position

GET /equipment/dome/set-park-position

Sets the current dome position as park position, if supported

Responses

  • 200 application/json

    Successful response

    Hide response attributes Show response attributes object
    • Response string
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
  • 400 application/json

    Dome not connected / parked

    Hide response attributes Show response attributes object
    • Response string
    • Error string

      Values are Dome not connected or Dome can not set park position.

    • StatusCode integer
    • Success boolean
    • Type string
  • 500 application/json

    Internal server error, Unknown error

    Hide response attributes Show response attributes object
    • Response string
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
GET /equipment/dome/set-park-position
curl \
 --request GET 'http://localhost:1888/v2/api/equipment/dome/set-park-position'
Response examples (200)
{
  "Response": "Park position set",
  "Error": "string",
  "StatusCode": 200,
  "Success": true,
  "Type": "API"
}
Response examples (400)
{
  "Response": "string",
  "Error": "Dome not connected",
  "StatusCode": 400,
  "Success": false,
  "Type": "API"
}
Response examples (500)
{
  "Response": "string",
  "Error": "Unknown error",
  "StatusCode": 500,
  "Success": false,
  "Type": "API"
}

Park

GET /equipment/dome/park

Parks the dome

Responses

  • 200 application/json

    Successful response

    Hide response attributes Show response attributes object
    • Response string

      Values are Parking or Dome already parked.

    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
  • 400 application/json

    Dome not connected

    Hide response attributes Show response attributes object
    • Response string
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
  • 500 application/json

    Internal server error, Unknown error

    Hide response attributes Show response attributes object
    • Response string
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
GET /equipment/dome/park
curl \
 --request GET 'http://localhost:1888/v2/api/equipment/dome/park'
Response examples (200)
{
  "Response": "Parking",
  "Error": "string",
  "StatusCode": 200,
  "Success": true,
  "Type": "API"
}
Response examples (400)
{
  "Response": "string",
  "Error": "Dome not connected",
  "StatusCode": 400,
  "Success": false,
  "Type": "API"
}
Response examples (500)
{
  "Response": "string",
  "Error": "Unknown error",
  "StatusCode": 500,
  "Success": false,
  "Type": "API"
}

Home

GET /equipment/dome/home

Homes the dome

Responses

  • 200 application/json

    Successful response

    Hide response attributes Show response attributes object
    • Response string

      Values are Homing or Dome already homed.

    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
  • 400 application/json

    Dome not connected

    Hide response attributes Show response attributes object
    • Response string
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
  • 500 application/json

    Internal server error, Unknown error

    Hide response attributes Show response attributes object
    • Response string
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
GET /equipment/dome/home
curl \
 --request GET 'http://localhost:1888/v2/api/equipment/dome/home'
Response examples (200)
{
  "Response": "Homing",
  "Error": "string",
  "StatusCode": 200,
  "Success": true,
  "Type": "API"
}
Response examples (400)
{
  "Response": "string",
  "Error": "Dome not connected",
  "StatusCode": 400,
  "Success": false,
  "Type": "API"
}
Response examples (500)
{
  "Response": "string",
  "Error": "Unknown error",
  "StatusCode": 500,
  "Success": false,
  "Type": "API"
}

Event Websocket

Event History

GET /event-history

Get event history

Responses

  • 200 application/json

    Successful response

    Hide response attributes Show response attributes object
    • Response array[object]
      Hide Response attributes Show Response attributes object
      • Event string
      • Time string
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
  • 500 application/json

    Internal server error, Unknown error

    Hide response attributes Show response attributes object
    • Response string
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
GET /event-history
curl \
 --request GET 'http://localhost:1888/v2/api/event-history'
Response examples (200)
{
  "Response": [
    {
      "Event": "string",
      "Time": "string"
    }
  ],
  "Error": "string",
  "StatusCode": 200,
  "Success": true,
  "Type": "API"
}
Response examples (500)
{
  "Response": "string",
  "Error": "Unknown error",
  "StatusCode": 500,
  "Success": false,
  "Type": "API"
}

FilterWheel

Information

GET /equipment/filterwheel/info

Get Filterwheel information

Responses

  • 200 application/json

    Successful response

    Hide response attributes Show response attributes object
    • Response object Required
      Hide Response attributes Show Response attributes object
      • Connected boolean Required
      • Name string Required
      • DisplayName string Required
      • Description string Required
      • DriverInfo string Required
      • DriverVersion string Required
      • DeviceId string Required
      • IsMoving boolean
      • SupportedActions array[string]
      • SelectedFilter object
        Hide SelectedFilter attributes Show SelectedFilter attributes object
        • Name string
        • Id integer
      • AvailableFilters array[object]
        Hide AvailableFilters attributes Show AvailableFilters attributes object
        • Name string Required
        • Id integer Required
    • Error string Required
    • StatusCode integer Required
    • Success boolean Required
    • Type string Required
  • 500 application/json

    Internal server error, Unknown error

    Hide response attributes Show response attributes object
    • Response string
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
GET /equipment/filterwheel/info
curl \
 --request GET 'http://localhost:1888/v2/api/equipment/filterwheel/info'
Response examples (200)
{
  "Response": {
    "Connected": true,
    "Name": "string",
    "DisplayName": "string",
    "Description": "string",
    "DriverInfo": "string",
    "DriverVersion": "string",
    "DeviceId": "string",
    "IsMoving": true,
    "SupportedActions": [
      "string"
    ],
    "SelectedFilter": {
      "Name": "string",
      "Id": 42
    },
    "AvailableFilters": [
      {
        "Name": "string",
        "Id": 42
      }
    ]
  },
  "Error": "string",
  "StatusCode": 42,
  "Success": true,
  "Type": "string"
}
Response examples (500)
{
  "Response": "string",
  "Error": "Unknown error",
  "StatusCode": 500,
  "Success": false,
  "Type": "API"
}

Connect

GET /equipment/filterwheel/connect

Connect to Filterwheel

Query parameters

  • to string

    The Id of the device that should be connected.

Responses

  • 200 application/json

    Successful response

    Hide response attributes Show response attributes object
    • Response string
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
  • 500 application/json

    Internal server error, Unknown error

    Hide response attributes Show response attributes object
    • Response string
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
GET /equipment/filterwheel/connect
curl \
 --request GET 'http://localhost:1888/v2/api/equipment/filterwheel/connect'
Response examples (200)
{
  "Response": "Connected",
  "Error": "string",
  "StatusCode": 200,
  "Success": true,
  "Type": "API"
}
Response examples (500)
{
  "Response": "string",
  "Error": "Unknown error",
  "StatusCode": 500,
  "Success": false,
  "Type": "API"
}

Disconnect

GET /equipment/filterwheel/disconnect

Disconnect the filterwheel

Responses

  • 200 application/json

    Successful response

    Hide response attributes Show response attributes object
    • Response string
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
  • 500 application/json

    Internal server error, Unknown error

    Hide response attributes Show response attributes object
    • Response string
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
GET /equipment/filterwheel/disconnect
curl \
 --request GET 'http://localhost:1888/v2/api/equipment/filterwheel/disconnect'
Response examples (200)
{
  "Response": "Disconnected",
  "Error": "string",
  "StatusCode": 200,
  "Success": true,
  "Type": "API"
}
Response examples (500)
{
  "Response": "string",
  "Error": "Unknown error",
  "StatusCode": 500,
  "Success": false,
  "Type": "API"
}

List Devices

GET /equipment/filterwheel/list-devices

List all devices which can be connected

Responses

  • 200 application/json

    Successful response

    Hide response attributes Show response attributes object
    • Response array[object]
      Hide Response attributes Show Response attributes object
      • HasSetupDialog boolean
      • Id string
      • Name string
      • DisplayName string
      • Category string
      • Connected boolean
      • Description string
      • DriverInfo string
      • DriverVersion string
      • SupportedActions array
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
  • 500 application/json

    Internal server error, Unknown error

    Hide response attributes Show response attributes object
    • Response string
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
GET /equipment/filterwheel/list-devices
curl \
 --request GET 'http://localhost:1888/v2/api/equipment/filterwheel/list-devices'
Response examples (200)
{
  "Response": [
    {
      "HasSetupDialog": true,
      "Id": "string",
      "Name": "string",
      "DisplayName": "string",
      "Category": "string",
      "Connected": true,
      "Description": "string",
      "DriverInfo": "string",
      "DriverVersion": "string",
      "SupportedActions": []
    }
  ],
  "Error": "string",
  "StatusCode": 200,
  "Success": true,
  "Type": "API"
}
Response examples (500)
{
  "Response": "string",
  "Error": "Unknown error",
  "StatusCode": 500,
  "Success": false,
  "Type": "API"
}

Rescan Devices

GET /equipment/filterwheel/rescan

Rescans for new devices, and returns a list of all available devices

Responses

  • 200 application/json

    Successful response

    Hide response attributes Show response attributes object
    • Response array[object]
      Hide Response attributes Show Response attributes object
      • HasSetupDialog boolean
      • Id string
      • Name string
      • DisplayName string
      • Category string
      • Connected boolean
      • Description string
      • DriverInfo string
      • DriverVersion string
      • SupportedActions array
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
  • 500 application/json

    Internal server error, Unknown error

    Hide response attributes Show response attributes object
    • Response string
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
GET /equipment/filterwheel/rescan
curl \
 --request GET 'http://localhost:1888/v2/api/equipment/filterwheel/rescan'
Response examples (200)
{
  "Response": [
    {
      "HasSetupDialog": true,
      "Id": "string",
      "Name": "string",
      "DisplayName": "string",
      "Category": "string",
      "Connected": true,
      "Description": "string",
      "DriverInfo": "string",
      "DriverVersion": "string",
      "SupportedActions": []
    }
  ],
  "Error": "string",
  "StatusCode": 200,
  "Success": true,
  "Type": "API"
}
Response examples (500)
{
  "Response": "string",
  "Error": "Unknown error",
  "StatusCode": 500,
  "Success": false,
  "Type": "API"
}

Change Filter

GET /equipment/filterwheel/change-filter

Change Filter

Query parameters

  • filterId integer Required

    The filter to change to.

Responses

  • 200 application/json

    Successful response

    Hide response attributes Show response attributes object
    • Response string
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
  • 409 application/json

    Filterwheel not connected / Filter not available

    Hide response attributes Show response attributes object
    • Response string
    • Error string

      Values are Filterwheel not connected or Filter not available.

    • StatusCode integer
    • Success boolean
    • Type string
  • 500 application/json

    Internal server error, Unknown error

    Hide response attributes Show response attributes object
    • Response string
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
GET /equipment/filterwheel/change-filter
curl \
 --request GET 'http://localhost:1888/v2/api/equipment/filterwheel/change-filter?filterId=42'
Response examples (200)
{
  "Response": "Filter changed",
  "Error": "string",
  "StatusCode": 200,
  "Success": true,
  "Type": "API"
}
Response examples (409)
{
  "Response": "string",
  "Error": "Filterwheel not connected",
  "StatusCode": 409,
  "Success": false,
  "Type": "API"
}
Response examples (500)
{
  "Response": "string",
  "Error": "Unknown error",
  "StatusCode": 500,
  "Success": false,
  "Type": "API"
}

Filter Information

GET /equipment/filterwheel/filter-info

Get Filterwheel Filter

Query parameters

  • filterId integer Required

    The filter to get.

Responses

  • 200 application/json

    Successful response

    Hide response attributes Show response attributes object
    • Response object Required
      Hide Response attributes Show Response attributes object
      • Name string Required
      • FocusOffset integer Required
      • Position integer Required
      • AutoFocusExposureTime integer Required
      • AutoFocusFilter boolean Required
      • FlatWizardFilterSettings object Required
        Hide FlatWizardFilterSettings attributes Show FlatWizardFilterSettings attributes object
        • FlatWizardMode integer Required
        • HistogramMeanTarget number Required
        • HistogramTolerance number Required
        • MaxFlatExposureTime integer Required
        • MinFlatExposureTime number Required
        • MaxAbsoluteFlatDeviceBrightness integer Required
        • MinAbsoluteFlatDeviceBrightness integer Required
        • Gain integer Required
        • Offset integer Required
        • Binning object Required
          Hide Binning attributes Show Binning attributes object
          • Name string Required
          • X integer Required
          • Y integer Required
      • AutoFocusBinning object Required
        Hide AutoFocusBinning attributes Show AutoFocusBinning attributes object
        • Name string Required
        • X integer Required
        • Y integer Required
      • AutoFocusGain integer Required
      • AutoFocusOffset integer Required
    • Error string Required
    • StatusCode integer Required
    • Success boolean Required
    • Type string Required
  • 409 application/json

    Error

    Hide response attributes Show response attributes object
    • Response string
    • Error string

      Values are Filterwheel not connected or Filter not available.

    • StatusCode integer
    • Success boolean
    • Type string
  • 500 application/json

    Internal server error, Unknown error

    Hide response attributes Show response attributes object
    • Response string
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
GET /equipment/filterwheel/filter-info
curl \
 --request GET 'http://localhost:1888/v2/api/equipment/filterwheel/filter-info?filterId=42'
Response examples (200)
{
  "Response": {
    "Name": "string",
    "FocusOffset": 42,
    "Position": 42,
    "AutoFocusExposureTime": 42,
    "AutoFocusFilter": true,
    "FlatWizardFilterSettings": {
      "FlatWizardMode": 42,
      "HistogramMeanTarget": 42.0,
      "HistogramTolerance": 42.0,
      "MaxFlatExposureTime": 42,
      "MinFlatExposureTime": 42.0,
      "MaxAbsoluteFlatDeviceBrightness": 42,
      "MinAbsoluteFlatDeviceBrightness": 42,
      "Gain": 42,
      "Offset": 42,
      "Binning": {
        "Name": "string",
        "X": 42,
        "Y": 42
      }
    },
    "AutoFocusBinning": {
      "Name": "string",
      "X": 42,
      "Y": 42
    },
    "AutoFocusGain": 42,
    "AutoFocusOffset": 42
  },
  "Error": "string",
  "StatusCode": 42,
  "Success": true,
  "Type": "string"
}
Response examples (409)
{
  "Response": "string",
  "Error": "Filterwheel not connected",
  "StatusCode": 409,
  "Success": false,
  "Type": "API"
}
Response examples (500)
{
  "Response": "string",
  "Error": "Unknown error",
  "StatusCode": 500,
  "Success": false,
  "Type": "API"
}

Flat Panel

Information

GET /equipment/flatdevice/info

Get information about the flat panel, Coverstate represents the following values: 0: Unknown, 1: NeitherOpenNorClosed, 2: Closed, 3: Open, 4: Error, 5: Not present

Responses

  • 200 application/json

    Successful response

    Hide response attributes Show response attributes object
    • Response object Required
      Hide Response attributes Show Response attributes object
      • CoverState string Required

        Values are Unknown, NeitherOpenNorClosed, Closed, Open, Error, or NotPresent.

      • LocalizedCoverState string Required
      • LocalizedLightOnState string Required
      • LightOn boolean Required
      • Brightness integer Required
      • SupportsOpenClose boolean Required
      • MinBrightness integer Required
      • MaxBrightness integer Required
      • SupportsOnOff boolean Required
      • SupportedActions array Required
      • Connected boolean Required
      • Name string Required
      • DisplayName string Required
      • Description string Required
      • DriverInfo string Required
      • DriverVersion string Required
      • DeviceId string Required
    • Error string Required
    • StatusCode integer Required
    • Success boolean Required
    • Type string Required
  • 500 application/json

    Internal server error, Unknown error

    Hide response attributes Show response attributes object
    • Response string
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
GET /equipment/flatdevice/info
curl \
 --request GET 'http://localhost:1888/v2/api/equipment/flatdevice/info'
Response examples (200)
{
  "Response": {
    "CoverState": "Unknown",
    "LocalizedCoverState": "string",
    "LocalizedLightOnState": "string",
    "LightOn": true,
    "Brightness": 42,
    "SupportsOpenClose": true,
    "MinBrightness": 42,
    "MaxBrightness": 42,
    "SupportsOnOff": true,
    "SupportedActions": [],
    "Connected": true,
    "Name": "string",
    "DisplayName": "string",
    "Description": "string",
    "DriverInfo": "string",
    "DriverVersion": "string",
    "DeviceId": "string"
  },
  "Error": "string",
  "StatusCode": 42,
  "Success": true,
  "Type": "string"
}
Response examples (500)
{
  "Response": "string",
  "Error": "Unknown error",
  "StatusCode": 500,
  "Success": false,
  "Type": "API"
}

Connect

GET /equipment/flatdevice/connect

Connect the flat panel

Query parameters

  • to string

    The Id of the device that should be connected.

Responses

  • 200 application/json

    Successful response

    Hide response attributes Show response attributes object
    • Response string
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
  • 500 application/json

    Internal server error, Unknown error

    Hide response attributes Show response attributes object
    • Response string
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
GET /equipment/flatdevice/connect
curl \
 --request GET 'http://localhost:1888/v2/api/equipment/flatdevice/connect'
Response examples (200)
{
  "Response": "Connected",
  "Error": "string",
  "StatusCode": 200,
  "Success": true,
  "Type": "API"
}
Response examples (500)
{
  "Response": "string",
  "Error": "Unknown error",
  "StatusCode": 500,
  "Success": false,
  "Type": "API"
}











































































































Determine Rotation

GET /framing/determine-rotation

Determine rotation from camera. This does nothing else than what the button in the framing assistant does. If waitForResult is set to true, the method will wait until the rotation is determined. This will only work if an image is loaded in the framing assistant

Query parameters

  • waitForResult boolean

    Whether to wait for the result.

Responses

  • 200 application/json

    Successful response

    One of:
    Hide attributes Show attributes
    • Response string
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
  • 400 application/json

    Process could not be started

    Hide response attributes Show response attributes object
    • Response string
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
  • 500 application/json

    Internal server error, Unknown error

    Hide response attributes Show response attributes object
    • Response string
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
GET /framing/determine-rotation
curl \
 --request GET 'http://localhost:1888/v2/api/framing/determine-rotation'
Response examples (200)
{
  "Response": "Determine rotation started",
  "Error": "string",
  "StatusCode": 200,
  "Success": true,
  "Type": "API"
}
{
  "Response": {
    "BoundHeight": 42,
    "BoundWidth": 42,
    "CameraHeight": 42,
    "CameraWidth": 42,
    "CameraPixelSize": 42,
    "DecDegrees": 42,
    "DecMinutes": 42,
    "DecSeconds": 42,
    "RAHours": 42,
    "RAMinutes": 42,
    "RASeconds": 42,
    "FieldOfView": 42,
    "FocalLength": 42,
    "HorizontalPanels": 42,
    "VerticalPanels": 42,
    "Rectangle": {
      "OriginalX": 42,
      "OriginalY": 42,
      "Id": 42,
      "DSOPositionAngle": 42,
      "OriginalOffset": 42,
      "RotationOffset": 42,
      "Rotation": 42,
      "TotalRotation": 42,
      "X": 42,
      "Y": 42,
      "Width": 42,
      "Height": 42
    }
  },
  "Error": "string",
  "StatusCode": 42,
  "Success": true,
  "Type": "string"
}
Response examples (400)
{
  "Response": "string",
  "Error": "Could not start process",
  "StatusCode": 400,
  "Success": false,
  "Type": "API"
}
Response examples (500)
{
  "Response": "string",
  "Error": "Unknown error",
  "StatusCode": 500,
  "Success": false,
  "Type": "API"
}

Guider





















Start Guiding

GET /equipment/guider/start

Start guiding

Query parameters

  • calibrate boolean

    Whether to force the guider to calibrate before start guiding

Responses

  • 200 application/json

    Successful response

    Hide response attributes Show response attributes object
    • Response string
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
  • 409 application/json

    Guider not connected

    Hide response attributes Show response attributes object
    • Response string
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
  • 500 application/json

    Internal server error, Unknown error

    Hide response attributes Show response attributes object
    • Response string
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
GET /equipment/guider/start
curl \
 --request GET 'http://localhost:1888/v2/api/equipment/guider/start'
Response examples (200)
{
  "Response": "Guiding started",
  "Error": "string",
  "StatusCode": 200,
  "Success": true,
  "Type": "API"
}
Response examples (409)
{
  "Response": "string",
  "Error": "Guider not connected",
  "StatusCode": 409,
  "Success": false,
  "Type": "API"
}
Response examples (500)
{
  "Response": "string",
  "Error": "Unknown error",
  "StatusCode": 500,
  "Success": false,
  "Type": "API"
}




Clear Calibration

GET /equipment/guider/clear-calibration

Clears the calibration data, forces the guider to recalibrate when it starts guiding

Responses

  • 200 application/json

    Successful response

    Hide response attributes Show response attributes object
    • Response string
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
  • 409 application/json

    Guider not connected

    Hide response attributes Show response attributes object
    • Response string
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
  • 500 application/json

    Internal server error, Unknown error

    Hide response attributes Show response attributes object
    • Response string
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
GET /equipment/guider/clear-calibration
curl \
 --request GET 'http://localhost:1888/v2/api/equipment/guider/clear-calibration'
Response examples (200)
{
  "Response": "Calibration cleared",
  "Error": "string",
  "StatusCode": 200,
  "Success": true,
  "Type": "API"
}
Response examples (409)
{
  "Response": "string",
  "Error": "Guider not connected",
  "StatusCode": 409,
  "Success": false,
  "Type": "API"
}
Response examples (500)
{
  "Response": "string",
  "Error": "Unknown error",
  "StatusCode": 500,
  "Success": false,
  "Type": "API"
}

Graph

GET /equipment/guider/graph

Gets the last n guide steps needed to construct a graph, with n being the number of saved steps as configured on the graph in NINA

Responses

  • 200 application/json

    Successful response

    Hide response attributes Show response attributes object
    • Response object
      Hide Response attributes Show Response attributes object
      • RMS object
        Hide RMS attributes Show RMS attributes object
        • RA number
        • Dec number
        • Total number
        • RAText string
        • DecText string
        • TotalText string
        • PeakRAText string
        • PeakDecText string
        • Scale number
        • PeakRA number
        • PeakDec number
        • DataPoints integer
      • Interval integer
      • MaxY integer
      • MinY integer
      • MaxDurationY integer
      • MinDurationY integer
      • GuideSteps array[object]
        Hide GuideSteps attributes Show GuideSteps attributes object
        • Id integer
        • IdOffsetLeft number
        • IdOffsetRight number
        • RADistanceRaw number
        • RADistanceRawDisplay number
        • RADuration integer
        • DECDistanceRaw number
        • DECDistanceRawDisplay number
        • DECDuration integer
        • Dither string
      • HistorySize integer
      • PixelScale number
      • Scale integer
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
  • 500 application/json

    Internal server error, Unknown error

    Hide response attributes Show response attributes object
    • Response string
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
GET /equipment/guider/graph
curl \
 --request GET 'http://localhost:1888/v2/api/equipment/guider/graph'
Response examples (200)
{
  "Response": {
    "RMS": {
      "RA": 42.0,
      "Dec": 42.0,
      "Total": 42.0,
      "RAText": "string",
      "DecText": "string",
      "TotalText": "string",
      "PeakRAText": "string",
      "PeakDecText": "string",
      "Scale": 42.0,
      "PeakRA": 42.0,
      "PeakDec": 42.0,
      "DataPoints": 42
    },
    "Interval": 42,
    "MaxY": 42,
    "MinY": 42,
    "MaxDurationY": 42,
    "MinDurationY": 42,
    "GuideSteps": [
      {
        "Id": 42,
        "IdOffsetLeft": 42.0,
        "IdOffsetRight": 42.0,
        "RADistanceRaw": 42.0,
        "RADistanceRawDisplay": 42.0,
        "RADuration": 42,
        "DECDistanceRaw": 42.0,
        "DECDistanceRawDisplay": 42.0,
        "DECDuration": 42,
        "Dither": "string"
      }
    ],
    "HistorySize": 42,
    "PixelScale": 42.0,
    "Scale": 42
  },
  "Error": "string",
  "StatusCode": 42,
  "Success": true,
  "Type": "string"
}
Response examples (500)
{
  "Response": "string",
  "Error": "Unknown error",
  "StatusCode": 500,
  "Success": false,
  "Type": "API"
}

Get Image

GET /image/{index}

Get image

Path parameters

  • index integer(int32) Required

    The index of the image to get

Query parameters

  • resize boolean

    Whether to resize the image.

  • quality integer(int32)

    The quality of the image, ranging from 1 (worst) to 100 (best). -1 or omitted for png

  • size string

    The size of the image ([width]x[height]). Requires resize to be true.

  • scale number(double)

    The scale of the image. Requires resize to be true.

  • factor number(double)

    The stretch factor to apply, between 0 and 1. Defaults to what is configured in the profile.

  • blackClipping number(double)

    The black clipping to apply. Defaults to what is configured in the profile.

  • unlinked boolean

    Indicates if the stretch should be unlinked. Defaults to what is configured in the profile.

  • stream boolean

    Stream the image to the client. This will stream the image in image/jpg or image/png format.

  • debayer boolean

    Indicates if the image should be debayered

  • bayerPattern string

    What bayer pattern to use for debayering, if debayer is true. If this is not specified, the api will try to use the bayer pattern that is configured in the profile as its first option, if that is set to Auto, the api will try to use the bayer pattern reported by the camera if it is connected. The fallback value is Monochrome.

    Values are Monochrome, Color, RGGB, CMYG, CMYG2, LRGB, BGGR, GBRG, GRBG, GRGB, GBGR, RGBG, or BGRG.

  • autoPrepare boolean

    Setting this to true will leave all processing up to NINA and you will recieve exactly the same image as you see in NINA. All other parameters related to image processing will have no effect.

  • imageType string

    Filter the image history by image type. This is useful if you got the index of an image using the history with a filter and now want to get the image. E.g. the 3rd flat in the image history is the 3rd flat in the image endpoint.

    Values are LIGHT, FLAT, DARK, BIAS, or SNAPSHOT.

  • raw_fits boolean

    Whether to send the image (without streaming) as a raw FITS format. Will return an error if the image is not of type FITS.

Responses

  • Successful response

    Hide response attributes Show response attributes object
    • Response string
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
  • 400 application/json

    Invalid image index / invalid bayer pattern / image is not a FITS file

    Hide response attributes Show response attributes object
    • Response string
    • Error string

      Values are Index out of range, Invalid bayer pattern, or Image is not a FITS file.

    • StatusCode integer
    • Success boolean
    • Type string
  • 500 application/json

    Internal server error, Unknown error

    Hide response attributes Show response attributes object
    • Response string
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
GET /image/{index}
curl \
 --request GET 'http://localhost:1888/v2/api/image/{index}'
Response examples (200)
{
  "Response": "<base64 encoded image>",
  "Error": "string",
  "StatusCode": 200,
  "Success": true,
  "Type": "API"
}
Response examples (400)
{
  "Response": "string",
  "Error": "Index out of range",
  "StatusCode": 400,
  "Success": false,
  "Type": "API"
}
Response examples (500)
{
  "Response": "string",
  "Error": "Unknown error",
  "StatusCode": 500,
  "Success": false,
  "Type": "API"
}












Livestack





Stop Livestack

GET /livestack/stop

Stops Livestack, requires Livestack >= v1.0.0.9. Note that this method cannot fail, even if the livestack plugin is not installed or something went wrong. This simply issues a command to stop the livestack.

Responses

  • 200 application/json

    Successful response

    Hide response attributes Show response attributes object
    • Response string
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
  • 500 application/json

    Internal server error, Unknown error

    Hide response attributes Show response attributes object
    • Response string
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
GET /livestack/stop
curl \
 --request GET 'http://localhost:1888/v2/api/livestack/stop'
Response examples (200)
{
  "Response": "Live stack stopped",
  "Error": "string",
  "StatusCode": 200,
  "Success": true,
  "Type": "API"
}
Response examples (500)
{
  "Response": "string",
  "Error": "Unknown error",
  "StatusCode": 500,
  "Success": false,
  "Type": "API"
}












Mount

Information

GET /equipment/mount/info

Get mount information

Responses

  • 200 application/json

    Successful response

    Hide response attributes Show response attributes object
    • Response object Required
      Hide Response attributes Show Response attributes object
      • SiderealTime number
      • RightAscension number
      • Declination number
      • SiteLatitude number
      • SiteLongitude number
      • SiteElevation number
      • RightAscensionString string
      • DeclinationString string
      • Coordinates object
        Hide Coordinates attributes Show Coordinates attributes object
        • RA number Required
        • RAString string Required
        • RADegrees number Required
        • Dec number Required
        • DecString string Required
        • Epoch string Required

          Values are JNOW, B1950, J2000, or J2050.

        • DateTime object Required
          Hide DateTime attributes Show DateTime attributes object
          • Now string Required
          • UtcNow string Required
      • TimeToMeridianFlip number
      • SideOfPier string

        Values are pierEast, pierWest, or pierUnknown.

      • Altitude number
      • AltitudeString string
      • Azimuth number
      • AzimuthString string
      • SiderealTimeString string
      • HoursToMeridianString string
      • AtPark boolean
      • TrackingRate object
      • TrackingEnabled boolean
      • TrackingModes array[string]

        Values are Siderial, Lunar, Solar, King, Custom, or Stopped.

      • AtHome boolean
      • CanFindHome boolean
      • CanPark boolean
      • CanSetPark boolean
      • CanSetTrackingEnabled boolean
      • CanSetDeclinationRate boolean
      • CanSetRightAscensionRate boolean
      • EquatorialSystem string

        Values are JNOW, B1950, J2000, or J2050.

      • HasUnknownEpoch boolean
      • TimeToMeridianFlipString string
      • Slewing boolean
      • GuideRateRightAscensionArcsecPerSec number
      • GuideRateDeclinationArcsecPerSec number
      • CanMovePrimaryAxis boolean
      • CanMoveSecondaryAxis boolean
      • PrimaryAxisRates array[object]
      • SecondaryAxisRates array[object]
      • SupportedActions array[string]
      • AlignmentMode string

        Values are AltAz, Polar, or GermanPolar.

      • CanPulseGuide boolean
      • IsPulseGuiding boolean
      • CanSetPierSide boolean
      • CanSlew boolean
      • UTCDate string
      • Connected boolean Required
      • Name string Required
      • DisplayName string Required
      • DeviceId string Required
    • Error string Required
    • StatusCode integer Required
    • Success boolean Required
    • Type string Required
  • 500 application/json

    Internal server error, Unknown error

    Hide response attributes Show response attributes object
    • Response string
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
GET /equipment/mount/info
curl \
 --request GET 'http://localhost:1888/v2/api/equipment/mount/info'
Response examples (200)
{
  "Response": {
    "SiderealTime": 42.0,
    "RightAscension": 42.0,
    "Declination": 42.0,
    "SiteLatitude": 42.0,
    "SiteLongitude": 42.0,
    "SiteElevation": 42.0,
    "RightAscensionString": "string",
    "DeclinationString": "string",
    "Coordinates": {
      "RA": 42.0,
      "RAString": "string",
      "RADegrees": 42.0,
      "Dec": 42.0,
      "DecString": "string",
      "Epoch": "JNOW",
      "DateTime": {
        "Now": "string",
        "UtcNow": "string"
      }
    },
    "TimeToMeridianFlip": 42.0,
    "SideOfPier": "pierEast",
    "Altitude": 42.0,
    "AltitudeString": "string",
    "Azimuth": 42.0,
    "AzimuthString": "string",
    "SiderealTimeString": "string",
    "HoursToMeridianString": "string",
    "AtPark": true,
    "TrackingRate": {},
    "TrackingEnabled": true,
    "TrackingModes": [
      "Siderial"
    ],
    "AtHome": true,
    "CanFindHome": true,
    "CanPark": true,
    "CanSetPark": true,
    "CanSetTrackingEnabled": true,
    "CanSetDeclinationRate": true,
    "CanSetRightAscensionRate": true,
    "EquatorialSystem": "JNOW",
    "HasUnknownEpoch": true,
    "TimeToMeridianFlipString": "string",
    "Slewing": true,
    "GuideRateRightAscensionArcsecPerSec": 42.0,
    "GuideRateDeclinationArcsecPerSec": 42.0,
    "CanMovePrimaryAxis": true,
    "CanMoveSecondaryAxis": true,
    "PrimaryAxisRates": [
      {}
    ],
    "SecondaryAxisRates": [
      {}
    ],
    "SupportedActions": [
      "string"
    ],
    "AlignmentMode": "AltAz",
    "CanPulseGuide": true,
    "IsPulseGuiding": true,
    "CanSetPierSide": true,
    "CanSlew": true,
    "UTCDate": "string",
    "Connected": true,
    "Name": "string",
    "DisplayName": "string",
    "DeviceId": "string"
  },
  "Error": "string",
  "StatusCode": 42,
  "Success": true,
  "Type": "string"
}
Response examples (500)
{
  "Response": "string",
  "Error": "Unknown error",
  "StatusCode": 500,
  "Success": false,
  "Type": "API"
}








List Devices

GET /equipment/mount/list-devices

List all devices which can be connected

Responses

  • 200 application/json

    Successful response

    Hide response attributes Show response attributes object
    • Response array[object]
      Hide Response attributes Show Response attributes object
      • HasSetupDialog boolean
      • Id string
      • Name string
      • DisplayName string
      • Category string
      • Connected boolean
      • Description string
      • DriverInfo string
      • DriverVersion string
      • SupportedActions array
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
  • 500 application/json

    Internal server error, Unknown error

    Hide response attributes Show response attributes object
    • Response string
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
GET /equipment/mount/list-devices
curl \
 --request GET 'http://localhost:1888/v2/api/equipment/mount/list-devices'
Response examples (200)
{
  "Response": [
    {
      "HasSetupDialog": true,
      "Id": "string",
      "Name": "string",
      "DisplayName": "string",
      "Category": "string",
      "Connected": true,
      "Description": "string",
      "DriverInfo": "string",
      "DriverVersion": "string",
      "SupportedActions": []
    }
  ],
  "Error": "string",
  "StatusCode": 200,
  "Success": true,
  "Type": "API"
}
Response examples (500)
{
  "Response": "string",
  "Error": "Unknown error",
  "StatusCode": 500,
  "Success": false,
  "Type": "API"
}








Tracking Mode

GET /equipment/mount/tracking

Set tracking mode

Query parameters

  • mode integer(int32) Required

    The tracking mode to set. 0: Siderial, 1: Lunar, 2: Solar, 3: King, 4: Stopped

    Minimum value is 0, maximum value is 4.

Responses

  • 200 application/json

    Successful response

    Hide response attributes Show response attributes object
    • Response string
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
  • 409 application/json

    Mount not connected / Mount parked / Invalid tracking mode

    Hide response attributes Show response attributes object
    • Response string
    • Error string

      Values are Mount not connected, Mount parked, or Invalid tracking mode.

    • StatusCode integer
    • Success boolean
    • Type string
  • 500 application/json

    Internal server error, Unknown error

    Hide response attributes Show response attributes object
    • Response string
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
GET /equipment/mount/tracking
curl \
 --request GET 'http://localhost:1888/v2/api/equipment/mount/tracking?mode=42'
Response examples (200)
{
  "Response": "Tracking mode changed",
  "Error": "string",
  "StatusCode": 200,
  "Success": true,
  "Type": "API"
}
Response examples (409)
{
  "Response": "string",
  "Error": "Mount not connected",
  "StatusCode": 409,
  "Success": false,
  "Type": "API"
}
Response examples (500)
{
  "Response": "string",
  "Error": "Unknown error",
  "StatusCode": 500,
  "Success": false,
  "Type": "API"
}




Unpark

GET /equipment/mount/unpark

Unpark the mount

Responses

  • 200 application/json

    Successful response

    Hide response attributes Show response attributes object
    • Response string

      Values are Unparking or Mount not parked.

    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
  • 409 application/json

    Mount not connected

    Hide response attributes Show response attributes object
    • Response string
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
  • 500 application/json

    Internal server error, Unknown error

    Hide response attributes Show response attributes object
    • Response string
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
GET /equipment/mount/unpark
curl \
 --request GET 'http://localhost:1888/v2/api/equipment/mount/unpark'
Response examples (200)
{
  "Response": "Unparking",
  "Error": "string",
  "StatusCode": 200,
  "Success": true,
  "Type": "API"
}
Response examples (409)
{
  "Response": "string",
  "Error": "Mount not connected",
  "StatusCode": 409,
  "Success": false,
  "Type": "API"
}
Response examples (500)
{
  "Response": "string",
  "Error": "Unknown error",
  "StatusCode": 500,
  "Success": false,
  "Type": "API"
}

Flip

GET /equipment/mount/flip

Performs a meridian flip to the current coordinates. This will only flip the mount if it is needed, it will not force the mount to flip

Responses

  • 200 application/json

    Successful response

    Hide response attributes Show response attributes object
    • Response string
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
  • 409 application/json

    Mount not connected / parked

    Hide response attributes Show response attributes object
    • Response string
    • Error string

      Values are Mount not connected or Mount parked.

    • StatusCode integer
    • Success boolean
    • Type string
  • 500 application/json

    Internal server error, Unknown error

    Hide response attributes Show response attributes object
    • Response string
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
GET /equipment/mount/flip
curl \
 --request GET 'http://localhost:1888/v2/api/equipment/mount/flip'
Response examples (200)
{
  "Response": "Flipping",
  "Error": "string",
  "StatusCode": 200,
  "Success": true,
  "Type": "API"
}
Response examples (409)
{
  "Response": "string",
  "Error": "Mount not connected",
  "StatusCode": 409,
  "Success": false,
  "Type": "API"
}
Response examples (500)
{
  "Response": "string",
  "Error": "Unknown error",
  "StatusCode": 500,
  "Success": false,
  "Type": "API"
}

Slew

GET /equipment/mount/slew

Performs a slew to the provided coordinates

Query parameters

  • ra number(double) Required

    The RA angle of the target in degree

  • dec number(double) Required

    The Dec angle of the target in degree

  • waitForResult boolean

    Whether to wait for the slew to finish

  • center boolean

    Whether to center the telescope on the target

  • rotate boolean

    Whether to perform a center and rotate

  • rotationAngle number(double)

    The rotation angle in degree

Responses

  • 200 application/json

    Successful response

    Hide response attributes Show response attributes object
    • Response string

      Values are Started Slew, Slew finished, or Slew failed.

    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
  • 409 application/json

    Mount not connected / parked

    Hide response attributes Show response attributes object
    • Response string
    • Error string

      Values are Mount not connected or Mount parked.

    • StatusCode integer
    • Success boolean
    • Type string
  • 500 application/json

    Internal server error, Unknown error

    Hide response attributes Show response attributes object
    • Response string
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
GET /equipment/mount/slew
curl \
 --request GET 'http://localhost:1888/v2/api/equipment/mount/slew?ra=42.0&dec=42.0'
Response examples (200)
{
  "Response": "Started Slew",
  "Error": "string",
  "StatusCode": 200,
  "Success": true,
  "Type": "API"
}
Response examples (409)
{
  "Response": "string",
  "Error": "Mount not connected",
  "StatusCode": 409,
  "Success": false,
  "Type": "API"
}
Response examples (500)
{
  "Response": "string",
  "Error": "Unknown error",
  "StatusCode": 500,
  "Success": false,
  "Type": "API"
}













Show Profile

GET /profile/show

Shows the profile

Query parameters

  • active boolean

    Whether to show the active profile or a list of all available profiles

Responses

  • 200 application/json

    Successful response

    Hide response attributes Show response attributes object
    • Response object
      Hide Response attributes Show Response attributes object
      • Name string
      • Description string
      • Id string
      • LastUsed string
      • ApplicationSettings object
        Hide ApplicationSettings attributes Show ApplicationSettings attributes object
        • Culture string
        • DevicePollingInterval integer
        • PageSize integer
        • LogLevel string

          Values are ERROR, WARNING, INFO, DEBUG, or TRACE.

      • AstrometrySettings object
        Hide AstrometrySettings attributes Show AstrometrySettings attributes object
        • Latitude number
        • Longitude number
        • Elevation integer
        • HorizonFilePath string
      • CameraSettings object
        Hide CameraSettings attributes Show CameraSettings attributes object
        • BitDepth integer
        • BulbMode string

          Values are NATIVE, SERIALPORT, SERIALRELAY, or TELESCOPESNAPPORT.

        • Id string
        • PixelSize integer
        • RawConverter string

          Values are DCRAW or FREEIMAGE.

        • SerialPort string
        • MinFlatExposureTime number
        • MaxFlatExposureTime integer
        • FileCameraFolder string
        • FileCameraUseBulbMode boolean
        • FileCameraIsBayered boolean
        • FileCameraExtension string
        • FileCameraAlwaysListen boolean
        • FileCameraDownloadDelay integer
        • BayerPattern string

          Values are None, Auto, RGGB, BGGR, GBRG, GRBG, GRGB, GBGR, RGBG, or BGRG.

        • FLIEnableFloodFlush boolean
        • FLIEnableSnapshotFloodFlush boolean
        • FLIFloodDuration integer
        • FLIFlushCount integer
        • BitScaling boolean
        • CoolingDuration integer
        • WarmingDuration integer
        • Temperature integer
        • Gain integer
        • Offset integer
        • QhyIncludeOverscan boolean
        • Timeout integer
        • DewHeaterOn boolean
        • ASCOMAllowUnevenPixelDimension boolean
        • MirrorLockupDelay integer
        • BinAverageEnabled boolean
        • TrackingCameraASCOMServerEnabled boolean
        • TrackingCameraASCOMServerPipeName string
        • TrackingCameraASCOMServerLoggingEnabled boolean
        • SBIGUseExternalCcdTracker boolean
        • AtikGainPreset integer
        • AtikExposureSpeed integer
        • AtikWindowHeaterPowerLevel integer
        • TouptekAlikeUltraMode boolean
        • TouptekAlikeHighFullwell boolean
        • TouptekAlikeLEDLights boolean
        • TouptekAlikeDewHeaterStrength integer
        • GenericCameraDewHeaterStrength integer
        • GenericCameraFanSpeed integer
        • ZwoAsiMonoBinMode boolean
        • ASCOMCreate32BitData boolean
        • BadPixelCorrection boolean
        • BadPixelCorrectionThreshold integer
      • ColorSchemaSettings object
        Hide ColorSchemaSettings attributes Show ColorSchemaSettings attributes object
        • AltColorSchema string
        • ColorSchema string
      • DomeSettings object
        Hide DomeSettings attributes Show DomeSettings attributes object
        • Id string
        • ScopePositionEastWest_mm integer
        • ScopePositionNorthSouth_mm integer
        • ScopePositionUpDown_mm integer
        • DomeRadius_mm integer
        • GemAxis_mm integer
        • LateralAxis_mm integer
        • AzimuthTolerance_degrees integer
        • FindHomeBeforePark boolean
        • DomeSyncTimeoutSeconds integer
        • SynchronizeDuringMountSlew boolean
        • SyncSlewDomeWhenMountSlews boolean
        • RotateDegrees integer
        • CloseOnUnsafe boolean
        • ParkMountBeforeShutterMove boolean
        • RefuseUnsafeShutterMove boolean
        • RefuseUnsafeShutterOpenSansSafetyDevice boolean
        • ParkDomeBeforeShutterMove boolean
        • MountType string

          Values are EQUATORIAL or FORK_ON_WEDGE.

        • DecOffsetHorizontal_mm integer
        • SettleTimeSeconds integer
      • FilterWheelSettings object
        Hide FilterWheelSettings attributes Show FilterWheelSettings attributes object
        • FilterWheelFilters array[object]
          Hide FilterWheelFilters attributes Show FilterWheelFilters attributes object
          • Name string
          • FocusOffset integer
          • Position integer
          • AutoFocusExposureTime integer
          • AutoFocusFilter boolean
          • FlatWizardFilterSettings object
            Hide FlatWizardFilterSettings attributes Show FlatWizardFilterSettings attributes object
            • FlatWizardMode string

              Values are DYNAMICEXPOSURE, DYNAMICBRIGHTNESS, or SKYFLAT.

            • HistogramMeanTarget number
            • HistogramTolerance number
            • MaxFlatExposureTime integer
            • MinFlatExposureTime number
            • MaxAbsoluteFlatDeviceBrightness integer
            • MinAbsoluteFlatDeviceBrightness integer
            • Gain integer
            • Offset integer
            • Binning object
              Hide Binning attributes Show Binning attributes object
              • Name string
              • X integer
              • Y integer
          • AutoFocusBinning object
            Hide AutoFocusBinning attributes Show AutoFocusBinning attributes object
            • Name string
            • X integer
            • Y integer
          • AutoFocusGain integer
          • AutoFocusOffset integer
        • Id string
        • DisableGuidingOnFilterChange boolean
        • Unidirectional boolean
      • FlatWizardSettings object
        Hide FlatWizardSettings attributes Show FlatWizardSettings attributes object
        • FlatCount integer
        • HistogramMeanTarget number
        • HistogramTolerance number
        • DarkFlatCount integer
        • OpenForDarkFlats boolean
        • AltitudeSite integer
        • FlatWizardMode string

          Values are DYNAMICEXPOSURE, DYNAMICBRIGHTNESS, or SKYFLAT.

      • FocuserSettings object
        Hide FocuserSettings attributes Show FocuserSettings attributes object
        • AutoFocusExposureTime integer
        • AutoFocusInitialOffsetSteps integer
        • AutoFocusStepSize integer
        • Id string
        • UseFilterWheelOffsets boolean
        • AutoFocusDisableGuiding boolean
        • FocuserSettleTime integer
        • AutoFocusTotalNumberOfAttempts integer
        • AutoFocusNumberOfFramesPerPoint integer
        • AutoFocusInnerCropRatio integer
        • AutoFocusOuterCropRatio integer
        • AutoFocusUseBrightestStars integer
        • BacklashIn integer
        • BacklashOut integer
        • AutoFocusBinning integer
        • AutoFocusCurveFitting string

          Values are TRENDLINES, PARABOLIC, TRENDPARABOLIC, HYPERBOLIC, or TRENDHYPERBOLIC.

        • AutoFocusMethod string

          Values are STARHFR or CONTRASTDETECTION.

        • ContrastDetectionMethod string

          Values are Sobel, Laplace, or Statistics.

        • BacklashCompensationModel string

          Values are ABSOLUTE or OVERSHOOT.

        • AutoFocusTimeoutSeconds integer
        • RSquaredThreshold number
      • FramingAssistantSettings object
        Hide FramingAssistantSettings attributes Show FramingAssistantSettings attributes object
        • CameraHeight integer
        • CameraWidth integer
        • FieldOfView integer
        • Opacity number
        • LastSelectedImageSource string

          Values are NASA, SKYSERVER, STSCI, ESO, HIPS2FITS, SKYATLAS, FILE, or CACHE.

        • LastRotationAngle integer
        • SaveImageInOfflineCache boolean
      • GuiderSettings object
        Hide GuiderSettings attributes Show GuiderSettings attributes object
        • GuiderName string
        • DitherPixels integer
        • DitherRAOnly boolean
        • PHD2GuiderScale string

          Values are PIXELS or ARCSECONDS.

        • MaxY integer
        • PHD2HistorySize integer
        • PHD2ServerPort integer
        • PHD2ServerUrl string
        • PHD2InstanceNumber integer
        • SettleTime integer
        • SettlePixels number
        • SettleTimeout integer
        • PHD2Path string
        • AutoRetryStartGuiding boolean
        • AutoRetryStartGuidingTimeoutSeconds integer
        • MetaGuideUseIpAddressAny boolean
        • MetaGuidePort integer
        • MGENFocalLength integer
        • MGENPixelMargin integer
        • MetaGuideMinIntensity integer
        • MetaGuideDitherSettleSeconds integer
        • MetaGuideLockWhenGuiding boolean
        • PHD2ROIPct integer
        • SkyGuardServerPort integer
        • SkyGuardServerUrl string
        • SkyGuardPath string
        • SkyGuardCallbackPort integer
        • SkyGuardTimeLapsChecked boolean
        • SkyGuardValueMaxGuiding integer
        • SkyGuardTimeLapsGuiding integer
        • SkyGuardTimeLapsDitherChecked boolean
        • SkyGuardValueMaxDithering integer
        • SkyGuardTimeLapsDithering integer
        • SkyGuardTimeOutGuiding integer
        • GuideChartRightAscensionColor object
          Hide GuideChartRightAscensionColor attributes Show GuideChartRightAscensionColor attributes object
          • A integer
          • R integer
          • G integer
          • B integer
          • ScA integer
          • ScR integer
          • ScG integer
          • ScB integer
        • GuideChartDeclinationColor object
          Hide GuideChartDeclinationColor attributes Show GuideChartDeclinationColor attributes object
          • A integer
          • R integer
          • G integer
          • B integer
          • ScA integer
          • ScR integer
          • ScG integer
          • ScB integer
        • GuideChartShowCorrections boolean
      • ImageFileSettings object
        Hide ImageFileSettings attributes Show ImageFileSettings attributes object
        • FilePath string
        • FilePattern string
        • FilePatternDARK string
        • FilePatternBIAS string
        • FilePatternFLAT string
        • FileType string

          Values are TIFF, FITS, XISF, TIFF_ZIP, TIFF_LZW, or RAW.

        • TIFFCompressionType string

          Values are NONE, ZIP, or LZW.

        • XISFCompressionType string

          Values are NONE, LZ4, LZ4HC, or ZLIB.

        • XISFChecksumType string

          Values are NONE, SHA1, SHA256, SHA512, SHA3_256, or SHA3_512.

        • XISFByteShuffling boolean
        • FITSCompressionType string

          Values are NONE, RICE, GZIP1, GZIP2, PLIO, or HCOMPRESS.

        • FITSAddFzExtension boolean
        • FITSUseLegacyWriter boolean
      • ImageSettings object
        Hide ImageSettings attributes Show ImageSettings attributes object
        • AnnotateImage boolean
        • DebayerImage boolean
        • DebayeredHFR boolean
        • UnlinkedStretch boolean
        • AnnotateUnlimitedStars boolean
        • AutoStretchFactor number
        • BlackClipping number
        • StarSensitivity string

          Values are Normal, High, or Highest.

        • NoiseReduction string

          Values are None, Median, Normal, High, or Highest.

        • DetectStars boolean
        • AutoStretch boolean
      • MeridianFlipSettings object
        Hide MeridianFlipSettings attributes Show MeridianFlipSettings attributes object
        • MinutesAfterMeridian integer
        • MaxMinutesAfterMeridian integer
        • PauseTimeBeforeMeridian integer
        • Recenter boolean
        • SettleTime integer
        • UseSideOfPier boolean
        • AutoFocusAfterFlip boolean
        • RotateImageAfterFlip boolean
      • PlanetariumSettings object
        Hide PlanetariumSettings attributes Show PlanetariumSettings attributes object
        • StellariumHost string
        • StellariumPort integer
        • CdCHost string
        • CdCPort integer
        • TSXHost string
        • TSXPort integer
        • TSXUseSelectedObject boolean
        • HNSKYHost string
        • HNSKYPort integer
        • C2AHost string
        • C2APort integer
        • SkytechXHost string
        • SkytechXPort integer
        • PreferredPlanetarium string

          Values are CDC, STELLARIUM, THESKYX, HNSKY, C2A, or SKYTECHX.

      • PlateSolveSettings object
        Hide PlateSolveSettings attributes Show PlateSolveSettings attributes object
        • AstrometryURL string
        • AstrometryAPIKey string
        • BlindSolverType string

          Values are ASTROMETRY_NET, LOCAL, ASPS, ASTAP, PLATESOLVE3, or PINPOINT.

        • CygwinLocation string
        • ExposureTime integer
        • Gain integer
        • Binning integer
        • PlateSolverType string

          Values are ASTROMETRY_NET, LOCAL, PLATESOLVE2, PLATESOLVE3, ASPS, ASTAP, TSX_IMAGELINK, or PINPONT.

        • PS2Location string
        • PS3Location string
        • Regions integer
        • SearchRadius integer
        • Threshold integer
        • RotationTolerance integer
        • ReattemptDelay integer
        • NumberOfAttempts integer
        • AspsLocation string
        • ASTAPLocation string
        • DownSampleFactor integer
        • MaxObjects integer
        • Sync boolean
        • SlewToTarget boolean
        • BlindFailoverEnabled boolean
        • TheSkyXHost string
        • TheSkyXPort integer
        • PinPointCatalogType string

          Values are ppGSCACT, ppTycho2, ppUSNO_A, ppUCAC2, ppUSNO_B, ppUCAC3, ppUCAC4, or ppAtlas.

        • PinPointCatalogRoot string
        • PinPointMaxMagnitude integer
        • PinPointExpansion integer
        • PinPointAllSkyApiKey string
        • PinPointAllSkyApiHost string
      • RotatorSettings object
        Hide RotatorSettings attributes Show RotatorSettings attributes object
        • Id string
        • Reverse2 boolean
        • RangeType string

          Values are FULL, HALF, or QUARTER.

        • RangeStartMechanicalPosition integer
      • FlatDeviceSettings object
        Hide FlatDeviceSettings attributes Show FlatDeviceSettings attributes object
        • Id string
        • PortName string
        • SettleTime integer
        • TrainedFlatExposureSettings array
      • SequenceSettings object
        Hide SequenceSettings attributes Show SequenceSettings attributes object
        • EstimatedDownloadTime string
        • TemplatePath string
        • TimeSpanInTicks integer
        • ParkMountAtSequenceEnd boolean
        • CloseDomeShutterAtSequenceEnd boolean
        • ParkDomeAtSequenceEnd boolean
        • WarmCamAtSequenceEnd boolean
        • DefaultSequenceFolder string
        • StartupSequenceTemplate string
        • SequencerTemplatesFolder string
        • SequencerTargetsFolder string
        • CollapseSequencerTemplatesByDefault boolean
        • CoolCameraAtSequenceStart boolean
        • UnparMountAtSequenceStart boolean
        • OpenDomeShutterAtSequenceStart boolean
        • DoMeridianFlip boolean
        • DisableSimpleSequencer boolean
      • SwitchSettings object
        Hide SwitchSettings attribute Show SwitchSettings attribute object
        • Id string
      • TelescopeSettings object
        Hide TelescopeSettings attributes Show TelescopeSettings attributes object
        • Name string
        • MountName string
        • FocalLength integer
        • FocalRatio integer
        • Id string
        • SettleTime integer
        • SnapPortStart string
        • SnapPortStop string
        • NoSync boolean
        • TimeSync boolean
        • PrimaryReversed boolean
        • SecondaryReversed boolean
        • TelescopeLocationSyncDirection string

          Values are PROMPT, TOAPPLICATION, TOTELESCOPE, or NOSYNC.

      • WeatherDataSettings object
        Hide WeatherDataSettings attributes Show WeatherDataSettings attributes object
        • Id string
        • OpenWeatherMapAPIKey string
        • TheWeatherCompanyAPIKey string
        • WeatherUndergroundAPIKey string
        • WeatherUndergroundStation string
      • SnapShotControlSettings object
        Hide SnapShotControlSettings attributes Show SnapShotControlSettings attributes object
        • ExposureDuration integer
        • Gain integer
        • Save boolean
        • Loop boolean
      • SafetyMonitorSettings object
        Hide SafetyMonitorSettings attribute Show SafetyMonitorSettings attribute object
        • Id string
      • AlpacaSettings object
        Hide AlpacaSettings attributes Show AlpacaSettings attributes object
        • NumberOfPolls integer
        • PollInterval integer
        • DiscoveryPort integer
        • DiscoveryDuration integer
        • ResolveDnsName boolean
        • UseIPv4 boolean
        • UseIPv6 boolean
        • UseHttps boolean
      • ImageHistorySettings object
        Hide ImageHistorySettings attributes Show ImageHistorySettings attributes object
        • ImageHistoryLeftSelected string

          Values are NONE, HFR, Stars, Median, Mean, StDev, MAD, Temperature, or Rms.

        • ImageHistoryRightSelected string

          Values are NONE, HFR, Stars, Median, Mean, StDev, MAD, Temperature, or Rms.

    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
  • 500 application/json

    Internal server error, Unknown error

    Hide response attributes Show response attributes object
    • Response string
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
GET /profile/show
curl \
 --request GET 'http://localhost:1888/v2/api/profile/show'
Response examples (200)
{
  "Response": {
    "Name": "string",
    "Description": "string",
    "Id": "string",
    "LastUsed": "string",
    "ApplicationSettings": {
      "Culture": "string",
      "DevicePollingInterval": 42,
      "PageSize": 42,
      "LogLevel": "ERROR"
    },
    "AstrometrySettings": {
      "Latitude": 42.0,
      "Longitude": 42.0,
      "Elevation": 42,
      "HorizonFilePath": "string"
    },
    "CameraSettings": {
      "BitDepth": 42,
      "BulbMode": "NATIVE",
      "Id": "string",
      "PixelSize": 42,
      "RawConverter": "DCRAW",
      "SerialPort": "string",
      "MinFlatExposureTime": 42.0,
      "MaxFlatExposureTime": 42,
      "FileCameraFolder": "string",
      "FileCameraUseBulbMode": true,
      "FileCameraIsBayered": true,
      "FileCameraExtension": "string",
      "FileCameraAlwaysListen": true,
      "FileCameraDownloadDelay": 42,
      "BayerPattern": "None",
      "FLIEnableFloodFlush": true,
      "FLIEnableSnapshotFloodFlush": true,
      "FLIFloodDuration": 42,
      "FLIFlushCount": 42,
      "BitScaling": true,
      "CoolingDuration": 42,
      "WarmingDuration": 42,
      "Temperature": 42,
      "Gain": 42,
      "Offset": 42,
      "QhyIncludeOverscan": true,
      "Timeout": 42,
      "DewHeaterOn": true,
      "ASCOMAllowUnevenPixelDimension": true,
      "MirrorLockupDelay": 42,
      "BinAverageEnabled": true,
      "TrackingCameraASCOMServerEnabled": true,
      "TrackingCameraASCOMServerPipeName": "string",
      "TrackingCameraASCOMServerLoggingEnabled": true,
      "SBIGUseExternalCcdTracker": true,
      "AtikGainPreset": 42,
      "AtikExposureSpeed": 42,
      "AtikWindowHeaterPowerLevel": 42,
      "TouptekAlikeUltraMode": true,
      "TouptekAlikeHighFullwell": true,
      "TouptekAlikeLEDLights": true,
      "TouptekAlikeDewHeaterStrength": 42,
      "GenericCameraDewHeaterStrength": 42,
      "GenericCameraFanSpeed": 42,
      "ZwoAsiMonoBinMode": true,
      "ASCOMCreate32BitData": true,
      "BadPixelCorrection": true,
      "BadPixelCorrectionThreshold": 42
    },
    "ColorSchemaSettings": {
      "AltColorSchema": "string",
      "ColorSchema": "string"
    },
    "DomeSettings": {
      "Id": "string",
      "ScopePositionEastWest_mm": 42,
      "ScopePositionNorthSouth_mm": 42,
      "ScopePositionUpDown_mm": 42,
      "DomeRadius_mm": 42,
      "GemAxis_mm": 42,
      "LateralAxis_mm": 42,
      "AzimuthTolerance_degrees": 42,
      "FindHomeBeforePark": true,
      "DomeSyncTimeoutSeconds": 42,
      "SynchronizeDuringMountSlew": true,
      "SyncSlewDomeWhenMountSlews": true,
      "RotateDegrees": 42,
      "CloseOnUnsafe": true,
      "ParkMountBeforeShutterMove": true,
      "RefuseUnsafeShutterMove": true,
      "RefuseUnsafeShutterOpenSansSafetyDevice": true,
      "ParkDomeBeforeShutterMove": true,
      "MountType": "EQUATORIAL",
      "DecOffsetHorizontal_mm": 42,
      "SettleTimeSeconds": 42
    },
    "FilterWheelSettings": {
      "FilterWheelFilters": [
        {
          "Name": "string",
          "FocusOffset": 42,
          "Position": 42,
          "AutoFocusExposureTime": 42,
          "AutoFocusFilter": true,
          "FlatWizardFilterSettings": {
            "FlatWizardMode": "DYNAMICEXPOSURE",
            "HistogramMeanTarget": 42.0,
            "HistogramTolerance": 42.0,
            "MaxFlatExposureTime": 42,
            "MinFlatExposureTime": 42.0,
            "MaxAbsoluteFlatDeviceBrightness": 42,
            "MinAbsoluteFlatDeviceBrightness": 42,
            "Gain": 42,
            "Offset": 42,
            "Binning": {
              "Name": "string",
              "X": 42,
              "Y": 42
            }
          },
          "AutoFocusBinning": {
            "Name": "string",
            "X": 42,
            "Y": 42
          },
          "AutoFocusGain": 42,
          "AutoFocusOffset": 42
        }
      ],
      "Id": "string",
      "DisableGuidingOnFilterChange": true,
      "Unidirectional": true
    },
    "FlatWizardSettings": {
      "FlatCount": 42,
      "HistogramMeanTarget": 42.0,
      "HistogramTolerance": 42.0,
      "DarkFlatCount": 42,
      "OpenForDarkFlats": true,
      "AltitudeSite": 42,
      "FlatWizardMode": "DYNAMICEXPOSURE"
    },
    "FocuserSettings": {
      "AutoFocusExposureTime": 42,
      "AutoFocusInitialOffsetSteps": 42,
      "AutoFocusStepSize": 42,
      "Id": "string",
      "UseFilterWheelOffsets": true,
      "AutoFocusDisableGuiding": true,
      "FocuserSettleTime": 42,
      "AutoFocusTotalNumberOfAttempts": 42,
      "AutoFocusNumberOfFramesPerPoint": 42,
      "AutoFocusInnerCropRatio": 42,
      "AutoFocusOuterCropRatio": 42,
      "AutoFocusUseBrightestStars": 42,
      "BacklashIn": 42,
      "BacklashOut": 42,
      "AutoFocusBinning": 42,
      "AutoFocusCurveFitting": "TRENDLINES",
      "AutoFocusMethod": "STARHFR",
      "ContrastDetectionMethod": "Sobel",
      "BacklashCompensationModel": "ABSOLUTE",
      "AutoFocusTimeoutSeconds": 42,
      "RSquaredThreshold": 42.0
    },
    "FramingAssistantSettings": {
      "CameraHeight": 42,
      "CameraWidth": 42,
      "FieldOfView": 42,
      "Opacity": 42.0,
      "LastSelectedImageSource": "NASA",
      "LastRotationAngle": 42,
      "SaveImageInOfflineCache": true
    },
    "GuiderSettings": {
      "GuiderName": "string",
      "DitherPixels": 42,
      "DitherRAOnly": true,
      "PHD2GuiderScale": "PIXELS",
      "MaxY": 42,
      "PHD2HistorySize": 42,
      "PHD2ServerPort": 42,
      "PHD2ServerUrl": "string",
      "PHD2InstanceNumber": 42,
      "SettleTime": 42,
      "SettlePixels": 42.0,
      "SettleTimeout": 42,
      "PHD2Path": "string",
      "AutoRetryStartGuiding": true,
      "AutoRetryStartGuidingTimeoutSeconds": 42,
      "MetaGuideUseIpAddressAny": true,
      "MetaGuidePort": 42,
      "MGENFocalLength": 42,
      "MGENPixelMargin": 42,
      "MetaGuideMinIntensity": 42,
      "MetaGuideDitherSettleSeconds": 42,
      "MetaGuideLockWhenGuiding": true,
      "PHD2ROIPct": 42,
      "SkyGuardServerPort": 42,
      "SkyGuardServerUrl": "string",
      "SkyGuardPath": "string",
      "SkyGuardCallbackPort": 42,
      "SkyGuardTimeLapsChecked": true,
      "SkyGuardValueMaxGuiding": 42,
      "SkyGuardTimeLapsGuiding": 42,
      "SkyGuardTimeLapsDitherChecked": true,
      "SkyGuardValueMaxDithering": 42,
      "SkyGuardTimeLapsDithering": 42,
      "SkyGuardTimeOutGuiding": 42,
      "GuideChartRightAscensionColor": {
        "A": 42,
        "R": 42,
        "G": 42,
        "B": 42,
        "ScA": 42,
        "ScR": 42,
        "ScG": 42,
        "ScB": 42
      },
      "GuideChartDeclinationColor": {
        "A": 42,
        "R": 42,
        "G": 42,
        "B": 42,
        "ScA": 42,
        "ScR": 42,
        "ScG": 42,
        "ScB": 42
      },
      "GuideChartShowCorrections": true
    },
    "ImageFileSettings": {
      "FilePath": "string",
      "FilePattern": "string",
      "FilePatternDARK": "string",
      "FilePatternBIAS": "string",
      "FilePatternFLAT": "string",
      "FileType": "TIFF",
      "TIFFCompressionType": "NONE",
      "XISFCompressionType": "NONE",
      "XISFChecksumType": "NONE",
      "XISFByteShuffling": true,
      "FITSCompressionType": "NONE",
      "FITSAddFzExtension": true,
      "FITSUseLegacyWriter": true
    },
    "ImageSettings": {
      "AnnotateImage": true,
      "DebayerImage": true,
      "DebayeredHFR": true,
      "UnlinkedStretch": true,
      "AnnotateUnlimitedStars": true,
      "AutoStretchFactor": 42.0,
      "BlackClipping": 42.0,
      "StarSensitivity": "Normal",
      "NoiseReduction": "None",
      "DetectStars": true,
      "AutoStretch": true
    },
    "MeridianFlipSettings": {
      "MinutesAfterMeridian": 42,
      "MaxMinutesAfterMeridian": 42,
      "PauseTimeBeforeMeridian": 42,
      "Recenter": true,
      "SettleTime": 42,
      "UseSideOfPier": true,
      "AutoFocusAfterFlip": true,
      "RotateImageAfterFlip": true
    },
    "PlanetariumSettings": {
      "StellariumHost": "string",
      "StellariumPort": 42,
      "CdCHost": "string",
      "CdCPort": 42,
      "TSXHost": "string",
      "TSXPort": 42,
      "TSXUseSelectedObject": true,
      "HNSKYHost": "string",
      "HNSKYPort": 42,
      "C2AHost": "string",
      "C2APort": 42,
      "SkytechXHost": "string",
      "SkytechXPort": 42,
      "PreferredPlanetarium": "CDC"
    },
    "PlateSolveSettings": {
      "AstrometryURL": "string",
      "AstrometryAPIKey": "string",
      "BlindSolverType": "ASTROMETRY_NET",
      "CygwinLocation": "string",
      "ExposureTime": 42,
      "Gain": 42,
      "Binning": 42,
      "PlateSolverType": "ASTROMETRY_NET",
      "PS2Location": "string",
      "PS3Location": "string",
      "Regions": 42,
      "SearchRadius": 42,
      "Threshold": 42,
      "RotationTolerance": 42,
      "ReattemptDelay": 42,
      "NumberOfAttempts": 42,
      "AspsLocation": "string",
      "ASTAPLocation": "string",
      "DownSampleFactor": 42,
      "MaxObjects": 42,
      "Sync": true,
      "SlewToTarget": true,
      "BlindFailoverEnabled": true,
      "TheSkyXHost": "string",
      "TheSkyXPort": 42,
      "PinPointCatalogType": "ppGSCACT",
      "PinPointCatalogRoot": "string",
      "PinPointMaxMagnitude": 42,
      "PinPointExpansion": 42,
      "PinPointAllSkyApiKey": "string",
      "PinPointAllSkyApiHost": "string"
    },
    "RotatorSettings": {
      "Id": "string",
      "Reverse2": true,
      "RangeType": "FULL",
      "RangeStartMechanicalPosition": 42
    },
    "FlatDeviceSettings": {
      "Id": "string",
      "PortName": "string",
      "SettleTime": 42,
      "TrainedFlatExposureSettings": []
    },
    "SequenceSettings": {
      "EstimatedDownloadTime": "string",
      "TemplatePath": "string",
      "TimeSpanInTicks": 42,
      "ParkMountAtSequenceEnd": true,
      "CloseDomeShutterAtSequenceEnd": true,
      "ParkDomeAtSequenceEnd": true,
      "WarmCamAtSequenceEnd": true,
      "DefaultSequenceFolder": "string",
      "StartupSequenceTemplate": "string",
      "SequencerTemplatesFolder": "string",
      "SequencerTargetsFolder": "string",
      "CollapseSequencerTemplatesByDefault": true,
      "CoolCameraAtSequenceStart": true,
      "UnparMountAtSequenceStart": true,
      "OpenDomeShutterAtSequenceStart": true,
      "DoMeridianFlip": true,
      "DisableSimpleSequencer": true
    },
    "SwitchSettings": {
      "Id": "string"
    },
    "TelescopeSettings": {
      "Name": "string",
      "MountName": "string",
      "FocalLength": 42,
      "FocalRatio": 42,
      "Id": "string",
      "SettleTime": 42,
      "SnapPortStart": "string",
      "SnapPortStop": "string",
      "NoSync": true,
      "TimeSync": true,
      "PrimaryReversed": true,
      "SecondaryReversed": true,
      "TelescopeLocationSyncDirection": "PROMPT"
    },
    "WeatherDataSettings": {
      "Id": "string",
      "OpenWeatherMapAPIKey": "string",
      "TheWeatherCompanyAPIKey": "string",
      "WeatherUndergroundAPIKey": "string",
      "WeatherUndergroundStation": "string"
    },
    "SnapShotControlSettings": {
      "ExposureDuration": 42,
      "Gain": 42,
      "Save": true,
      "Loop": true
    },
    "SafetyMonitorSettings": {
      "Id": "string"
    },
    "AlpacaSettings": {
      "NumberOfPolls": 42,
      "PollInterval": 42,
      "DiscoveryPort": 42,
      "DiscoveryDuration": 42,
      "ResolveDnsName": true,
      "UseIPv4": true,
      "UseIPv6": true,
      "UseHttps": true
    },
    "ImageHistorySettings": {
      "ImageHistoryLeftSelected": "NONE",
      "ImageHistoryRightSelected": "NONE"
    }
  },
  "Error": "string",
  "StatusCode": 200,
  "Success": true,
  "Type": "API"
}
Response examples (500)
{
  "Response": "string",
  "Error": "Unknown error",
  "StatusCode": 500,
  "Success": false,
  "Type": "API"
}

Change Profile Value

GET /profile/change-value

Changes a value in the profile

Query parameters

  • settingpath string Required

    The path to the setting to change. (eg. CameraSettings-PixelSize). This refers the the profile structure like it is recieved when using /profile/show?active=true. Seperate each object with a dash (-)

  • newValue object Required

    The new value to set

Responses

  • 200 application/json

    Successful response

    Hide response attributes Show response attributes object
    • Response string
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
  • 400 application/json

    Invalid path / Invalid value

    Hide response attributes Show response attributes object
    • Response string
    • Error string

      Values are Invalid path or New value can't be null.

    • StatusCode integer
    • Success boolean
    • Type string
  • 500 application/json

    Internal server error, Unknown error

    Hide response attributes Show response attributes object
    • Response string
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
GET /profile/change-value
curl \
 --request GET 'http://localhost:1888/v2/api/profile/change-value?settingpath=CameraSettings-PixelSize&newValue=3.2'
Response examples (200)
{
  "Response": "Updated setting",
  "Error": "string",
  "StatusCode": 200,
  "Success": true,
  "Type": "API"
}
Response examples (400)
{
  "Response": "string",
  "Error": "Invalid path",
  "StatusCode": 400,
  "Success": false,
  "Type": "API"
}
Response examples (500)
{
  "Response": "string",
  "Error": "Unknown error",
  "StatusCode": 500,
  "Success": false,
  "Type": "API"
}









Information

GET /equipment/rotator/info

Get rotator information

Responses

  • 200 application/json

    Successful response

    Hide response attributes Show response attributes object
    • Response object Required
      Hide Response attributes Show Response attributes object
      • CanReverse boolean Required
      • Reverse boolean Required
      • MechanicalPosition integer Required
      • Position integer Required
      • StepSize number Required
      • IsMoving boolean Required
      • Synced boolean Required
      • SupportedActions array Required
      • Connected boolean Required
      • Name string Required
      • DisplayName string Required
      • Description string Required
      • DriverInfo string Required
      • DriverVersion string Required
      • DeviceId string Required
    • Error string Required
    • StatusCode integer Required
    • Success boolean Required
    • Type string Required
  • 500 application/json

    Internal server error, Unknown error

    Hide response attributes Show response attributes object
    • Response string
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
GET /equipment/rotator/info
curl \
 --request GET 'http://localhost:1888/v2/api/equipment/rotator/info'
Response examples (200)
{
  "Response": {
    "CanReverse": true,
    "Reverse": true,
    "MechanicalPosition": 42,
    "Position": 42,
    "StepSize": 42.0,
    "IsMoving": true,
    "Synced": true,
    "SupportedActions": [],
    "Connected": true,
    "Name": "string",
    "DisplayName": "string",
    "Description": "string",
    "DriverInfo": "string",
    "DriverVersion": "string",
    "DeviceId": "string"
  },
  "Error": "string",
  "StatusCode": 42,
  "Success": true,
  "Type": "string"
}
Response examples (500)
{
  "Response": "string",
  "Error": "Unknown error",
  "StatusCode": 500,
  "Success": false,
  "Type": "API"
}














































JSON

GET /sequence/json

Get sequence as json. This endpoint is generally advised to use over state since it gives more reliable results.

Responses

  • 200 application/json

    Successful response, best to try it out yourself

    Hide response attributes Show response attributes object
    • Response array[object]
      One of:
      Hide attributes Show attributes
      • Conditions array
      • Items array

        Contains sequence instructions as well as containers

      • Triggers array
      • Status string
      • Name string
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
  • 409 application/json

    Sequencer not initialized

    Hide response attributes Show response attributes object
    • Response string
    • Error string

      Value is Sequencer not initialized.

    • StatusCode integer
    • Success boolean
    • Type string
  • 500 application/json

    Internal server error, Unknown error

    Hide response attributes Show response attributes object
    • Response string
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
GET /sequence/json
curl \
 --request GET 'http://localhost:1888/v2/api/sequence/json'
Response examples (200)
{
  "Response": [
    {
      "Conditions": [],
      "Items": [],
      "Triggers": [],
      "Status": "string",
      "Name": "string"
    }
  ],
  "Error": "string",
  "StatusCode": 200,
  "Success": true,
  "Type": "API"
}
Response examples (409)
{
  "Response": "string",
  "Error": "Sequencer not initialized",
  "StatusCode": 409,
  "Success": false,
  "Type": "API"
}
Response examples (500)
{
  "Response": "string",
  "Error": "Unknown error",
  "StatusCode": 500,
  "Success": false,
  "Type": "API"
}




Edit a Sequence

GET /sequence/edit

This works similary to profile/set-value. Note that this mainly supports fields that expect simple types like strings, numbers etc, and may not work for things like enums or objects (filter, time source, ...). This is an experimental feature, and it could have unexpected side effects or simply not work for some instructions or fields. If you encounter any bugs (except that it is not working with enums or objects), feel free to create an issue on github or contact me on the NINA discord.

Query parameters

  • path string Required

    The path to the property that should be updated. Use GlobalTriggers, Start, Imaging, End for the sequence root containers. Then use the name of the property or the index of the item in a list, seperated with -. The example would set the exposure time of a Take Exposure instruction, contained in a DSO container, to 20s. Use sequence/state as reference, not sequence/json!

  • value string Required

    The new value

Responses

  • 200 application/json

    Successful response

    Hide response attributes Show response attributes object
    • Response string
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
  • 400 application/json

    Faulty state

    Hide response attributes Show response attributes object
    • Response string
    • Error string

      Values are Sequence is not initialized, Invalid path, or New value can't be null.

    • StatusCode integer
    • Success boolean
    • Type string
  • 500 application/json

    Internal server error, Unknown error

    Hide response attributes Show response attributes object
    • Response string
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
GET /sequence/edit
curl \
 --request GET 'http://localhost:1888/v2/api/sequence/edit?path=Imaging-Items-0-Items-0-ExposureTime&value=20'
Response examples (200)
{
  "Response": "Updated setting",
  "Error": "string",
  "StatusCode": 200,
  "Success": true,
  "Type": "API"
}
Response examples (400)
{
  "Response": "string",
  "Error": "Sequence is not initialized",
  "StatusCode": 400,
  "Success": false,
  "Type": "API"
}
Response examples (500)
{
  "Response": "string",
  "Error": "Unknown error",
  "StatusCode": 500,
  "Success": false,
  "Type": "API"
}

































Connect

GET /equipment/switch/connect

Connect to Switch

Query parameters

  • to string

    The Id of the device that should be connected.

Responses

  • 200 application/json

    Successful response

    Hide response attributes Show response attributes object
    • Response string
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
  • 500 application/json

    Internal server error, Unknown error

    Hide response attributes Show response attributes object
    • Response string
    • Error string
    • StatusCode integer
    • Success boolean
    • Type string
GET /equipment/switch/connect
curl \
 --request GET 'http://localhost:1888/v2/api/equipment/switch/connect'
Response examples (200)
{
  "Response": "Connected",
  "Error": "string",
  "StatusCode": 200,
  "Success": true,
  "Type": "API"
}
Response examples (500)
{
  "Response": "string",
  "Error": "Unknown error",
  "StatusCode": 500,
  "Success": false,
  "Type": "API"
}