> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nebyoulous.space/llms.txt
> Use this file to discover all available pages before exploring further.

# Submit a stack job for an integration set.



## OpenAPI

````yaml /api-reference/openapi.json post /integration-sets/{id}/stack-jobs
openapi: 3.0.3
info:
  title: Nebyoulous API
  description: >-
    REST API behind the Nebyoulous web app, CLI, and MCP server. Requests that
    act on your data need a bearer token.
  version: 0.0.0
servers:
  - url: https://api.nebyoulous.space
    description: Production
security: []
tags:
  - name: System
    description: Service health.
  - name: Account
    description: The signed-in user and their profile.
  - name: Integration sets
    description: Sets of frames for one target.
  - name: Uploads
    description: Presigned uploads into an integration set.
  - name: Assets
    description: Download, view, preview, and delete uploaded files.
  - name: Stacking and analysis
    description: >-
      Stack jobs, frame analysis, and frame QA. All run asynchronously: submit,
      then poll.
  - name: Exports
    description: Export an integration set as an archive.
  - name: Gear and rigs
    description: Equipment items and the rigs built from them.
  - name: Planner
    description: Nightly scores, saved locations, and sessions.
  - name: Catalog
    description: The deep-sky object catalog.
  - name: Light pollution
    description: Sky brightness for a location.
  - name: Posts
    description: Your drafts and published posts.
  - name: Public posts
    description: Published posts anyone can read.
  - name: Comments and annotations
    description: Threads and replies on published posts.
  - name: Mentions
    description: Mentions of you in comments.
  - name: Advisor usage
    description: Your advisor usage ledger.
paths:
  /integration-sets/{id}/stack-jobs:
    post:
      tags:
        - Stacking and analysis
      summary: Submit a stack job for an integration set.
      parameters:
        - schema:
            type: string
            format: uuid
            pattern: >-
              ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
          in: path
          name: id
          required: true
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                groups:
                  type: object
                  properties:
                    light:
                      maxItems: 1000
                      type: array
                      items:
                        type: string
                        minLength: 1
                        maxLength: 1024
                    dark:
                      maxItems: 1000
                      type: array
                      items:
                        type: string
                        minLength: 1
                        maxLength: 1024
                    flat:
                      maxItems: 1000
                      type: array
                      items:
                        type: string
                        minLength: 1
                        maxLength: 1024
                    bias:
                      maxItems: 1000
                      type: array
                      items:
                        type: string
                        minLength: 1
                        maxLength: 1024
                    darkflat:
                      maxItems: 1000
                      type: array
                      items:
                        type: string
                        minLength: 1
                        maxLength: 1024
                  required:
                    - light
                config:
                  type: object
                  properties:
                    version:
                      type: number
                      enum:
                        - 1
                    calibrate:
                      type: object
                      properties:
                        sensor:
                          type: string
                          enum:
                            - osc
                            - mono
                        cosmeticCorrection:
                          type: boolean
                      required:
                        - sensor
                        - cosmeticCorrection
                    register:
                      type: object
                      properties:
                        referencePath:
                          type: string
                          minLength: 1
                          maxLength: 1024
                    filter:
                      type: object
                      properties:
                        fwhm:
                          type: object
                          properties:
                            value:
                              type: number
                              minimum: 0
                              exclusiveMinimum: true
                            mode:
                              type: string
                              enum:
                                - threshold
                                - sigma
                                - percent
                          required:
                            - value
                            - mode
                        wfwhm:
                          type: object
                          properties:
                            value:
                              type: number
                              minimum: 0
                              exclusiveMinimum: true
                            mode:
                              type: string
                              enum:
                                - threshold
                                - sigma
                                - percent
                          required:
                            - value
                            - mode
                        roundness:
                          type: object
                          properties:
                            value:
                              type: number
                              minimum: 0
                              exclusiveMinimum: true
                            mode:
                              type: string
                              enum:
                                - threshold
                                - sigma
                                - percent
                          required:
                            - value
                            - mode
                        nbstars:
                          type: object
                          properties:
                            value:
                              type: number
                              minimum: 0
                              exclusiveMinimum: true
                            mode:
                              type: string
                              enum:
                                - threshold
                                - sigma
                                - percent
                          required:
                            - value
                            - mode
                        bkg:
                          type: object
                          properties:
                            value:
                              type: number
                              minimum: 0
                              exclusiveMinimum: true
                            mode:
                              type: string
                              enum:
                                - threshold
                                - sigma
                                - percent
                          required:
                            - value
                            - mode
                        quality:
                          type: object
                          properties:
                            value:
                              type: number
                              minimum: 0
                              exclusiveMinimum: true
                            mode:
                              type: string
                              enum:
                                - threshold
                                - sigma
                                - percent
                          required:
                            - value
                            - mode
                        includedOnly:
                          type: boolean
                    stack:
                      type: object
                      properties:
                        method:
                          type: string
                          enum:
                            - mean
                            - median
                            - sum
                            - min
                            - max
                        rejection:
                          type: string
                          enum:
                            - winsorized_sigma
                            - sigma
                            - linear_fit
                            - percentile
                            - mad
                            - generalized
                            - none
                        sigmaLow:
                          type: number
                          minimum: 0
                          exclusiveMinimum: true
                          maximum: 100
                        sigmaHigh:
                          type: number
                          minimum: 0
                          exclusiveMinimum: true
                          maximum: 100
                        normalize:
                          type: string
                          enum:
                            - none
                            - additive
                            - multiplicative
                            - additive_scaling
                            - multiplicative_scaling
                        outputNorm:
                          type: boolean
                        weighting:
                          type: string
                          enum:
                            - none
                            - noise
                            - nbstack
                            - wfwhm
                        rgbEqual:
                          type: boolean
                      required:
                        - method
                        - rejection
                        - sigmaLow
                        - sigmaHigh
                        - normalize
                        - outputNorm
                        - weighting
                        - rgbEqual
                  required:
                    - version
                    - calibrate
                    - register
                    - stack
                params:
                  type: object
                  properties:
                    engine:
                      type: string
                      enum:
                        - siril
                    method:
                      type: string
                      enum:
                        - mean
                        - median
                        - sum
                        - min
                        - max
                    rejection:
                      type: string
                      enum:
                        - winsorized_sigma
                        - sigma
                        - linear_fit
                        - percentile
                        - mad
                        - generalized
                        - none
                    sigmaLow:
                      type: number
                      minimum: 0
                      exclusiveMinimum: true
                      maximum: 100
                    sigmaHigh:
                      type: number
                      minimum: 0
                      exclusiveMinimum: true
                      maximum: 100
                    normalize:
                      type: string
                      enum:
                        - none
                        - additive
                        - multiplicative
                        - additive_scaling
                        - multiplicative_scaling
                    outputNorm:
                      type: boolean
                    weighting:
                      type: string
                      enum:
                        - none
                        - noise
                        - nbstack
                        - wfwhm
                    rgbEqual:
                      type: boolean
                    sensor:
                      type: string
                      enum:
                        - osc
                        - mono
                    cosmeticCorrection:
                      type: boolean
                referencePath:
                  type: string
                  minLength: 1
                  maxLength: 1024
                sourceAnalysisId:
                  type: string
                  format: uuid
                  pattern: >-
                    ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
                excludedFrames:
                  maxItems: 1000
                  type: array
                  items:
                    type: string
                    minLength: 1
                    maxLength: 1024
              required:
                - groups
      responses:
        '202':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  job:
                    type: object
                    properties:
                      id:
                        type: string
                        format: uuid
                        pattern: >-
                          ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
                      status:
                        type: string
                        enum:
                          - PENDING
                          - RUNNING
                          - READY
                          - FAILED
                          - CANCELLED
                      stackName:
                        type: string
                      sourceStackName:
                        nullable: true
                        type: string
                      params:
                        type: object
                        properties:
                          engine:
                            type: string
                            enum:
                              - siril
                          method:
                            type: string
                            enum:
                              - mean
                              - median
                              - sum
                              - min
                              - max
                          rejection:
                            type: string
                            enum:
                              - winsorized_sigma
                              - sigma
                              - linear_fit
                              - percentile
                              - mad
                              - generalized
                              - none
                          sigmaLow:
                            type: number
                          sigmaHigh:
                            type: number
                          normalize:
                            type: string
                            enum:
                              - none
                              - additive
                              - multiplicative
                              - additive_scaling
                              - multiplicative_scaling
                          outputNorm:
                            type: boolean
                          weighting:
                            type: string
                            enum:
                              - none
                              - noise
                              - nbstack
                              - wfwhm
                          rgbEqual:
                            type: boolean
                          sensor:
                            type: string
                            enum:
                              - osc
                              - mono
                          cosmeticCorrection:
                            type: boolean
                        required:
                          - engine
                          - method
                          - rejection
                          - sigmaLow
                          - sigmaHigh
                          - normalize
                          - outputNorm
                          - weighting
                          - rgbEqual
                          - sensor
                          - cosmeticCorrection
                        additionalProperties: false
                      referencePath:
                        nullable: true
                        type: string
                      totalFrames:
                        nullable: true
                        type: integer
                        minimum: -9007199254740991
                        maximum: 9007199254740991
                      frameCounts:
                        nullable: true
                        type: object
                        properties:
                          light:
                            type: object
                            properties:
                              used:
                                type: integer
                                minimum: 0
                                maximum: 9007199254740991
                              rejected:
                                type: integer
                                minimum: 0
                                maximum: 9007199254740991
                            required:
                              - used
                              - rejected
                            additionalProperties: false
                          dark:
                            nullable: true
                            type: object
                            properties:
                              used:
                                type: integer
                                minimum: 0
                                maximum: 9007199254740991
                              rejected:
                                type: integer
                                minimum: 0
                                maximum: 9007199254740991
                            required:
                              - used
                              - rejected
                            additionalProperties: false
                          flat:
                            nullable: true
                            type: object
                            properties:
                              used:
                                type: integer
                                minimum: 0
                                maximum: 9007199254740991
                              rejected:
                                type: integer
                                minimum: 0
                                maximum: 9007199254740991
                            required:
                              - used
                              - rejected
                            additionalProperties: false
                          bias:
                            nullable: true
                            type: object
                            properties:
                              used:
                                type: integer
                                minimum: 0
                                maximum: 9007199254740991
                              rejected:
                                type: integer
                                minimum: 0
                                maximum: 9007199254740991
                            required:
                              - used
                              - rejected
                            additionalProperties: false
                          darkflat:
                            nullable: true
                            type: object
                            properties:
                              used:
                                type: integer
                                minimum: 0
                                maximum: 9007199254740991
                              rejected:
                                type: integer
                                minimum: 0
                                maximum: 9007199254740991
                            required:
                              - used
                              - rejected
                            additionalProperties: false
                        required:
                          - light
                          - dark
                          - flat
                          - bias
                          - darkflat
                        additionalProperties: false
                      runReport:
                        nullable: true
                        type: object
                        properties:
                          lightFramesUsed:
                            type: integer
                            minimum: 0
                            maximum: 9007199254740991
                          lightFramesFiltered:
                            type: integer
                            minimum: 0
                            maximum: 9007199254740991
                          medianFwhm:
                            type: number
                            minimum: 0
                          backgroundNoise:
                            type: number
                            minimum: 0
                          pixelRejectionLow:
                            type: number
                            minimum: 0
                          pixelRejectionHigh:
                            type: number
                            minimum: 0
                        additionalProperties: false
                      engine:
                        nullable: true
                        type: string
                        enum:
                          - siril
                      outputS3Key:
                        nullable: true
                        type: string
                      outputSizeBytes:
                        nullable: true
                        type: number
                      errorMessage:
                        nullable: true
                        type: string
                      createdAt:
                        type: string
                      updatedAt:
                        type: string
                      completedAt:
                        nullable: true
                        type: string
                      downloadUrl:
                        type: string
                    required:
                      - id
                      - status
                      - stackName
                      - sourceStackName
                      - params
                      - referencePath
                      - totalFrames
                      - frameCounts
                      - runReport
                      - engine
                      - outputS3Key
                      - outputSizeBytes
                      - errorMessage
                      - createdAt
                      - updatedAt
                      - completedAt
                    additionalProperties: false
                required:
                  - job
                additionalProperties: false
        '400':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: string
                  message:
                    type: string
                required:
                  - code
                  - message
                additionalProperties: false
        '401':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: string
                  message:
                    type: string
                required:
                  - code
                  - message
                additionalProperties: false
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        An access token issued by a Nebyoulous sign-in: the web session,
        `nebyoulous login`, or an MCP OAuth grant.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.