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

# Update Job Opening



## OpenAPI

````yaml /actionkit/openapi.json POST /projects/{project_id}/tools/#GREENHOUSE_UPDATE_JOB_OPENING
openapi: 3.0.0
info:
  title: ActionKit Tools API
  version: 1.0.0
servers:
  - url: https://actionkit.useparagon.com
    description: US Cloud
security: []
paths:
  /projects/{project_id}/tools/#GREENHOUSE_UPDATE_JOB_OPENING:
    post:
      summary: Update Job Opening
      parameters:
        - name: project_id
          in: path
          required: true
          schema:
            type: string
            description: >-
              Your Paragon Project ID. You can copy your Project ID from your
              dashboard URL or by clicking Copy Project ID under the Environment
              switcher.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                tool:
                  type: string
                  default: GREENHOUSE_UPDATE_JOB_OPENING
                parameters:
                  type: object
                  properties:
                    jobId:
                      type: string
                      description: >-
                        Job ID : The ID of the job you want to create an
                        application to for this candidate (example:
                        "4007253006")
                    internalOpeningId:
                      type: string
                      description: >-
                        ID : The ID of the opening and this is the immutable
                        internal id. (example: "abc-123")
                    openingId:
                      type: string
                      description: >-
                        Opening ID : This is a string that contains an
                        opening_id. This may be a blank string. Changing an
                        opening_id may re-trigger approvals. For approvals to
                        start recruiting, this will reset approvals only if the
                        job is in draft mode. If the job is open for hiring,
                        these approvals will not reset. For official job
                        approvals, this will reset approvals only if the job is
                        open. (example: "4007253006")
                    status:
                      type: string
                      description: Status
                      enum:
                        - open
                        - closed
                    customFields:
                      type: object
                      description: |-
                        Custom Fields (example: "[
                          {
                              "id": 123,
                              "value": "jacob"
                          }
                        ]")
                      properties: {}
                  required:
                    - jobId
                    - internalOpeningId
                  x-integration: greenhouse
              required:
                - tool
                - parameters
      responses:
        '200':
          description: Success
      security:
        - BearerAuth: []
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >-
        Your [Paragon User
        Token](/getting-started/installing-the-connect-sdk#setup) (JWT), which
        you can generate using your project's signing keys.

````