> ## 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.

# Trigger an immediate run of a scheduled job

> Starts an immediate run of an existing scheduled job, without waiting for its cron schedule.
The call returns the run id once the run is created. The run starts as the user who
scheduled the job.
Required permissions: `StartJob`, `UseGlobalCompute`

Returns 409 if the schedule is paused, or if its previous run has not completed and the
schedule does not allow concurrent runs. Returns 404 if the scheduled job does not exist in
the project or the project is archived.




## OpenAPI

````yaml /api-specs/cloud/public-api.json post /api/scheduledjobs/v1/projects/{projectId}/scheduledjobs/{scheduledJobId}/run
openapi: 3.0.3
info:
  title: Domino Public API
  description: Reference for Domino's public REST API endpoints.
  version: 7.0.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: MLflow experiments and runs
  - name: MLflow models
  - name: MLflow artifacts
  - name: MLflow traces
  - 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/scheduledjobs/v1/projects/{projectId}/scheduledjobs/{scheduledJobId}/run:
    post:
      tags:
        - Jobs
      summary: Trigger an immediate run of a scheduled job
      description: >
        Starts an immediate run of an existing scheduled job, without waiting
        for its cron schedule.

        The call returns the run id once the run is created. The run starts as
        the user who

        scheduled the job.

        Required permissions: `StartJob`, `UseGlobalCompute`


        Returns 409 if the schedule is paused, or if its previous run has not
        completed and the

        schedule does not allow concurrent runs. Returns 404 if the scheduled
        job does not exist in

        the project or the project is archived.
      operationId: runScheduledJobNow
      parameters:
        - description: Id of the project
          in: path
          name: projectId
          required: true
          schema:
            pattern: ^[0-9a-f]{24}$
            type: string
        - description: Id of the scheduled job to run
          in: path
          name: scheduledJobId
          required: true
          schema:
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RunScheduledJobNowResponseV1'
          description: success
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '403':
          $ref: '#/components/responses/403'
        '404':
          $ref: '#/components/responses/404'
        '409':
          $ref: '#/components/responses/409'
        '500':
          $ref: '#/components/responses/500'
      security:
        - DominoApiKey: []
        - BearerAuthentication: []
components:
  schemas:
    RunScheduledJobNowResponseV1:
      properties:
        runId:
          description: Id of the run that was queued
          example: 5f8f8c44e4b0f1a2b3c4d5e6
          type: string
      required:
        - runId
      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
    FailureEnvelopeV1:
      properties:
        errors:
          description: Errors that caused a request to fail
          items:
            type: string
          type: array
        requestId:
          description: Id used to correlate a request with server actions.
          example: bbd78579-93c4-45ee-a983-0d5c8da6d5b1
          type: string
      required:
        - requestId
        - errors
      type: object
  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
    '409':
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/FailureEnvelopeV1'
      description: >-
        The request could not be completed due to a conflict with the current
        state of the target resource.
    '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

- [Domino Cloud release notes](https://docs.domino.ai/release-notes/cloud-release.md)
- [Schedule Jobs](https://docs.domino.ai/cloud/platform-capabilities/core-concepts/jobs/schedule-a-job.md)
- [Work with Jobs](https://docs.domino.ai/cloud/platform-capabilities/core-concepts/jobs/index.md)
- [Create and run Jobs](https://docs.domino.ai/cloud/platform-capabilities/core-concepts/jobs/create-and-run-jobs.md)
