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

# Resolve the default configuration a Job would run with

> Resolve the configuration a Job in this project would run with, without starting anything. Every field in the request body is optional: what you send is taken as an override, and everything you leave out is filled in from the project's defaults. The response reports the fully resolved hardware tier, environment and revision, git ref, dataset and NetApp volume snapshots, external volumes and volume size, so a caller can show or record the exact configuration before creating a Job.

Seven fields are named exactly as `POST /api/jobs/v1/jobs` names them, so each resolved value can be copied straight into a start-Job request: `hardwareTier`, `environmentId`, `environmentRevisionSpec`, `mainRepoGitRef`, `computeCluster`, `externalVolumeMountIds` and `netAppVolumeIds`. `commitId` is named the same but carries over only for projects using Domino's internal file store; see the field description on `NewJobV1`. The remaining fields have no counterpart on `NewJobV1`: `datasetSnapshots`, `netAppVolumeSnapshots`, `volumeSizeGiB`, `resolvedMainRepoGitRef` and `resolvedImportedGitRepoRefs` are reported for inspection, not for starting a Job. Send the individual fields rather than the whole object.

Resolution is read-only and leaves no trace on the project. Required permissions: `ViewJobs`



## OpenAPI

````yaml /api-specs/cloud/public-api.json post /api/jobs/v1/projects/{projectId}/job-defaults
openapi: 3.0.3
info:
  title: Domino Public API
  description: Reference for Domino's public REST API endpoints.
  version: 6.4.0
  x-catalog-key: nucleus
servers:
  - url: https://mycluster.domino.tech
    description: >-
      Replace 'mycluster.domino.tech' with your Domino cluster hostname. For
      Domino Cloud customers, that is `your-subdomain`.domino.tech (e.g.,
      acme.domino.tech). For self-hosted deployments, it is the hostname you
      reach the Domino UI at.
security: []
tags:
  - name: Projects
  - name: Project templates
  - name: Workspaces
  - name: Jobs
  - name: HPC Jobs
  - name: Environments
  - name: Hardware Tiers
  - name: Datasets
  - name: Data Sources
  - name: GenAI
  - name: AI Systems
  - name: Apps
  - name: App versions
  - name: App instances
  - name: Model APIs
  - name: Registered models
  - name: Model deployment
  - name: Extensions
  - name: Cost and billing
  - name: Users and organizations
  - name: Service accounts
  - name: Personal Access Tokens
  - name: Personal Access Tokens (admin)
  - name: Audit Trail
  - name: Custom metrics
  - name: PPM
  - name: Model Monitoring models
  - name: Model Monitoring drift and quality
  - name: Model Monitoring settings
  - name: Model Monitoring authentication
  - name: Governance bundles
  - name: Governance policies
  - name: Governance evidence and results
  - name: Governance operations
  - name: NetApp Volumes
  - name: NetApp Volumes snapshots
  - name: NetApp Volumes filesystems
  - name: NetApp Volumes transfers
  - name: Tags
  - name: Properties
externalDocs:
  description: OpenAPI
  url: https://swagger.io/resources/open-api/
paths:
  /api/jobs/v1/projects/{projectId}/job-defaults:
    post:
      tags:
        - Jobs
      summary: Resolve the default configuration a Job would run with
      description: >-
        Resolve the configuration a Job in this project would run with, without
        starting anything. Every field in the request body is optional: what you
        send is taken as an override, and everything you leave out is filled in
        from the project's defaults. The response reports the fully resolved
        hardware tier, environment and revision, git ref, dataset and NetApp
        volume snapshots, external volumes and volume size, so a caller can show
        or record the exact configuration before creating a Job.


        Seven fields are named exactly as `POST /api/jobs/v1/jobs` names them,
        so each resolved value can be copied straight into a start-Job request:
        `hardwareTier`, `environmentId`, `environmentRevisionSpec`,
        `mainRepoGitRef`, `computeCluster`, `externalVolumeMountIds` and
        `netAppVolumeIds`. `commitId` is named the same but carries over only
        for projects using Domino's internal file store; see the field
        description on `NewJobV1`. The remaining fields have no counterpart on
        `NewJobV1`: `datasetSnapshots`, `netAppVolumeSnapshots`,
        `volumeSizeGiB`, `resolvedMainRepoGitRef` and
        `resolvedImportedGitRepoRefs` are reported for inspection, not for
        starting a Job. Send the individual fields rather than the whole object.


        Resolution is read-only and leaves no trace on the project. Required
        permissions: `ViewJobs`
      operationId: resolveJobDefaults
      parameters:
        - description: ID of the project to resolve Job defaults for
          in: path
          name: projectId
          required: true
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/JobDefaultsRequestV1'
        description: >-
          Overrides to apply before resolving the remaining values from the
          project's defaults. Send an empty object to resolve every value from
          the project.
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JobDefaultsEnvelopeV1'
          description: Success
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '403':
          $ref: '#/components/responses/403'
        '404':
          $ref: '#/components/responses/404'
        '500':
          $ref: '#/components/responses/500'
      security:
        - DominoApiKey: []
        - BearerAuthentication: []
components:
  schemas:
    JobDefaultsRequestV1:
      description: >
        Overrides to apply before resolving. Every field is optional; anything
        left out is resolved from the project's defaults. Fields shared with
        POST /api/jobs/v1/jobs use the names that endpoint uses;
        datasetSnapshots, netAppVolumeSnapshots, volumeSizeGiB and
        importedGitRepoOverrides have no counterpart there.
      properties:
        commitId:
          description: >-
            Commit to resolve against. Applies only to the project's internal
            DFS commit history; use mainRepoGitRef for a git-based project's
            main repository.
          example: 960a4c99a4cc38194cbacbcce41caa68ba5369ea
          type: string
        computeCluster:
          $ref: '#/components/schemas/ComputeClusterConfigV1'
        datasetSnapshots:
          description: >-
            Dataset snapshots to resolve against. Defaults to the snapshots the
            project mounts.
          items:
            $ref: '#/components/schemas/DatasetSnapshotRefV1'
          type: array
        environmentId:
          description: >-
            Id of the environment to resolve against. Defaults to the project's
            default environment.
          example: 623131507a0af0281c01a699
          type: string
        environmentRevisionSpec:
          $ref: '#/components/schemas/EnvironmentRevisionSpecV1'
        externalVolumeMountIds:
          description: >-
            Ids of external volumes to resolve against. Defaults to the volumes
            the project mounts.
          example:
            - 6231327c7a0af0281c01a69b
            - 623132867a0af0281c01a69c
          items:
            type: string
          type: array
        hardwareTier:
          description: >-
            Hardware tier to resolve against. Defaults to the project's default
            hardware tier.
          example: small-k8s
          type: string
        importedGitRepoOverrides:
          description: >-
            Per-imported-repository git refs to resolve against. Defaults to
            each repository's default ref.
          items:
            $ref: '#/components/schemas/ImportedGitRepoRefOverrideV1'
          type: array
        mainRepoGitRef:
          $ref: '#/components/schemas/GitRefV1'
        netAppVolumeIds:
          description: >-
            Ids of NetApp volumes to resolve against. Defaults to the volumes
            the project mounts.
          example:
            - 31c4a22a-5571-4e9b-b7ac-921d241acd00
          items:
            type: string
          type: array
        netAppVolumeSnapshots:
          description: >-
            NetApp volume snapshots to resolve against. Defaults to the
            snapshots the project mounts.
          items:
            $ref: '#/components/schemas/NetAppVolumeSnapshotRefV1'
          type: array
        volumeSizeGiB:
          description: >-
            Volume size in GiB to resolve against. Defaults to the project's
            configured size.
          example: 10
          format: double
          type: number
      type: object
    JobDefaultsEnvelopeV1:
      properties:
        jobDefaults:
          $ref: '#/components/schemas/JobDefaultsV1'
        metadata:
          $ref: '#/components/schemas/MetadataV1'
      required:
        - jobDefaults
        - metadata
      type: object
    ComputeClusterConfigV1:
      properties:
        clusterType:
          $ref: '#/components/schemas/ClusterTypeV1'
        computeEnvironmentId:
          description: Id of compute environment to use.
          example: 623139857a0af0281c01a6a4
          type: string
        computeEnvironmentRevisionSpec:
          $ref: '#/components/schemas/EnvironmentRevisionSpecV1'
        masterHardwareTierId:
          description: Hardware tier to use for master node in compute cluster.
          example: medium-k8s
          type: string
        maxWorkerCount:
          description: >-
            Max number of workers to use in compute cluster. Enables
            auto-scaling for cluster when present.
          example: 10
          type: integer
        workerCount:
          description: >-
            Number of workers to use in compute cluster. Used as min number of
            workers in maxWorkerCount is set.
          example: 4
          type: integer
        workerHardwareTier:
          description: Hardware tier to use for workers in compute cluster.
          example: large-k8s
          type: string
        workerStorageMB:
          description: >-
            Disk size in megabytes for each worker. A value read from a job can
            be sent back to POST /api/jobs/v1/jobs unchanged.
          example: 5
          type: number
      required:
        - clusterType
        - computeEnvironmentId
        - workerCount
        - workerHardwareTier
      type: object
    DatasetSnapshotRefV1:
      properties:
        datasetId:
          description: Id of the dataset.
          example: 6231365e7a0af0281c01a69f
          type: string
        datasetName:
          description: >-
            Name of the dataset. Reported for convenience when resolving
            defaults.
          example: training-data
          type: string
        snapshotVersion:
          description: Version of the dataset snapshot.
          example: 3
          type: integer
      required:
        - datasetId
        - snapshotVersion
      type: object
    EnvironmentRevisionSpecV1:
      description: >-
        Specification describing which environment revision to use. Defaults to
        "ActiveRevision"
      example: ActiveRevision | LatestRevision | SomeRevision(623131577a0af0281c01a69a)
      type: string
    ImportedGitRepoRefOverrideV1:
      properties:
        id:
          description: Id of the imported git repository in the project.
          example: 6231365e7a0af0281c01a69f
          type: string
        ref:
          $ref: '#/components/schemas/GitRefV1'
        resolvedCommitId:
          description: Commit SHA the ref resolves to.
          example: dff155c9a736f9cd230eac420e3c1ef3daa0ad7e
          type: string
      required:
        - id
        - ref
      type: object
    GitRefV1:
      properties:
        refType:
          description: The type of git reference being used.
          example: head | commitId | tags | branches
          type: string
        value:
          description: >-
            The value of the git reference. Only necessary for relevant git ref
            types.
          example: my-test-branch
          type: string
      required:
        - refType
      type: object
    NetAppVolumeSnapshotRefV1:
      properties:
        snapshotVersion:
          description: Version of the volume snapshot. Omitted when no snapshot is pinned.
          example: 2
          type: integer
        volumeId:
          description: Id of the NetApp volume.
          example: 31c4a22a-5571-4e9b-b7ac-921d241acd00
          type: string
        volumeName:
          description: >-
            Name of the NetApp volume. Reported for convenience when resolving
            defaults.
          example: shared-scratch
          type: string
      required:
        - volumeId
      type: object
    JobDefaultsV1:
      description: >
        The fully resolved configuration a Job would run with. Fields shared
        with the request body of POST /api/jobs/v1/jobs use the names that
        endpoint uses, so each shared value can be copied into a start-Job
        request; the object as a whole is not a start-Job body.
        resolvedMainRepoGitRef, resolvedImportedGitRepoRefs, datasetSnapshots,
        netAppVolumeSnapshots and volumeSizeGiB are reported for inspection and
        have no counterpart on NewJobV1.
      properties:
        commitId:
          description: The resolved commit in the project's internal DFS commit history.
          example: 960a4c99a4cc38194cbacbcce41caa68ba5369ea
          type: string
        computeCluster:
          $ref: '#/components/schemas/ComputeClusterConfigV1'
        datasetSnapshots:
          description: The resolved dataset snapshots.
          items:
            $ref: '#/components/schemas/DatasetSnapshotRefV1'
          type: array
        environmentId:
          description: Id of the resolved environment.
          example: 623131507a0af0281c01a699
          type: string
        environmentRevisionSpec:
          $ref: '#/components/schemas/EnvironmentRevisionSpecV1'
        externalVolumeMountIds:
          description: Ids of the resolved external volumes.
          items:
            type: string
          type: array
        hardwareTier:
          description: The resolved hardware tier.
          example: small-k8s
          type: string
        mainRepoGitRef:
          $ref: '#/components/schemas/GitRefV1'
        netAppVolumeIds:
          description: Ids of the resolved NetApp volumes.
          items:
            type: string
          type: array
        netAppVolumeSnapshots:
          description: The resolved NetApp volume snapshots.
          items:
            $ref: '#/components/schemas/NetAppVolumeSnapshotRefV1'
          type: array
        resolvedImportedGitRepoRefs:
          additionalProperties:
            type: string
          description: >-
            Commit SHAs for the project's imported git repositories, keyed by
            repository id.
          example:
            6231365e7a0af0281c01a69f: dff155c9a736f9cd230eac420e3c1ef3daa0ad7e
          type: object
        resolvedMainRepoGitRef:
          description: >-
            The commit SHA mainRepoGitRef points at, looked up against the
            project's main git remote. Omitted when the project has no main
            repository or the lookup failed.
          example: 4f2d5c2f54db4fbb16a093d4fb11fdb1fe0794c7
          type: string
        volumeSizeGiB:
          description: The resolved volume size in GiB.
          example: 10
          format: double
          type: number
      required:
        - commitId
        - hardwareTier
        - environmentId
        - environmentRevisionSpec
        - datasetSnapshots
        - netAppVolumeSnapshots
        - externalVolumeMountIds
        - netAppVolumeIds
        - volumeSizeGiB
      type: object
    MetadataV1:
      properties:
        notices:
          description: Notices relating to the request
          items:
            type: string
          type: array
        requestId:
          type: string
      required:
        - requestId
        - notices
      type: object
    ErrorV1:
      properties:
        code:
          description: Machine-readable error code.
          example: NOT_FOUND
          type: string
        message:
          description: Human-readable description of the error.
          example: The requested HPC Job could not be found.
          type: string
      required:
        - message
      type: object
    ClusterTypeV1:
      description: Type of compute cluster
      enum:
        - dask
        - mpi
        - ray
        - slurm
        - spark
      type: string
  responses:
    '400':
      content:
        application/json:
          schema:
            properties:
              error:
                type: string
            type: object
      description: Bad Request
    '401':
      content:
        application/json:
          example:
            code: UNAUTHORIZED
            message: Authentication is required to access this resource.
          schema:
            $ref: '#/components/schemas/ErrorV1'
      description: Unauthorized - authentication is required or has failed.
    '403':
      content:
        application/json:
          example:
            code: FORBIDDEN
            message: You do not have permission to perform this action.
          schema:
            $ref: '#/components/schemas/ErrorV1'
      description: Forbidden - the caller lacks permission to perform this action.
    '404':
      content:
        application/json:
          schema:
            properties:
              error:
                type: string
            type: object
      description: Not Found
    '500':
      content:
        application/json:
          schema:
            properties:
              error:
                type: string
            type: object
      description: Internal Server Error
  securitySchemes:
    DominoApiKey:
      type: apiKey
      in: header
      name: X-Domino-Api-Key
    BearerAuthentication:
      type: apiKey
      name: Authorization
      in: header

````

## Related topics

- [Create and run Jobs](/cloud/platform-capabilities/core-concepts/jobs/create-and-run-jobs.md)
- [Domino Cloud release notes](/release-notes/cloud-release.md)
- [Run HPC workloads with Slurm](/cloud/platform-capabilities/features/compute-clusters-hpc/slurm/index.md)
- [Monitor Jobs](/cloud/platform-capabilities/core-concepts/jobs/monitor-jobs.md)