openapi: 3.1.0
info:
  title: dbt Cloud Administrative Accounts Jobs API
  description: The dbt Cloud Administrative API enables programmatic management of dbt Cloud accounts, projects, jobs, runs, environments, and other resources. The API supports automation of dbt Cloud workflows and integration with external orchestration tools.
  version: '3'
  contact:
    name: dbt Labs Support
    url: https://www.getdbt.com/community
servers:
- url: https://cloud.getdbt.com/api/v3
  description: Multi-tenant production
- url: https://cloud.getdbt.com/api/v2
  description: Legacy v2 API
security:
- bearerAuth: []
tags:
- name: Jobs
paths:
  /accounts/{accountId}/jobs/:
    get:
      summary: List jobs
      operationId: listJobs
      tags:
      - Jobs
      parameters:
      - in: path
        name: accountId
        required: true
        schema:
          type: integer
      responses:
        '200':
          description: A list of jobs.
    post:
      summary: Create a job
      operationId: createJob
      tags:
      - Jobs
      parameters:
      - in: path
        name: accountId
        required: true
        schema:
          type: integer
      responses:
        '201':
          description: Job created.
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: Token