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

# Patch job

> 
This API call allows for partial updates to jobs, modifying specific fields without overwriting
those not included in the update request.

Differing from [Edit job](../job/edit-job), this call employs a PATCH method, updating only the provided fields
without altering others. It's beneficial when editing a subset of supported fields is required.

The call supports the editing of status, due date, and providers. When editing providers, it's essential to submit
both the ID of the provider and its type (either VENDOR or USER).

The response will provide a subset of information from [Get job](../job/get-job).




## OpenAPI

````yaml /openapi/phrase-tms-v1.json patch /api2/v1/projects/{projectUid}/jobs/{jobUid}
openapi: 3.0.0
info:
  description: |-
    Welcome to Phrase's TMS API documentation. 

     Please visit our [help center](https://support.phrase.com/hc/en-us/sections/5709662083612) for more information about the APIs. 

     If you have any questions, please contact [Support](https://support.phrase.com/hc/requests/new). 

     Please, include the `User-Agent` header with the name of your application or project. It might be a good idea to include some sort of contact information as well, so that we can get in touch if necessary. Examples of excellent `User-Agent` headers:
     > User-Agent: Example mobile app (example@phrase.com) <br/> User-Agent: ACME Inc Java 1.8 Client (http://acmeinc.com/contact)
  version: '1'
  title: Phrase TMS API
servers:
  - url: https://cloud.memsource.com/web
security:
  - ApiToken: []
  - OAuth2: []
tags:
  - name: Additional Workflow Step
  - name: Analysis
  - name: Async Request
  - name: Authentication
  - name: Automations
  - name: Bilingual File
  - name: Business Unit
  - name: Buyer
  - name: Client
  - name: Connector
  - name: Conversations
  - name: Cost Center
  - name: Custom Fields
  - name: Custom File Type
  - name: Domain
  - name: Due Date Scheme
  - name: Email Template
  - name: File
  - name: Glossary
  - name: Import settings
  - name: Job
  - name: Language AI
  - name: Language Assets
  - name: Language Quality Assessment
  - name: Machine Translation
  - name: Machine Translation Settings
  - name: Mapping
  - name: Net Rate Scheme
  - name: Notifications
  - name: Price List
  - name: Project
  - name: Project Template
  - name: Provider
  - name: Quality Assurance
  - name: Quality Profile
  - name: Quote
  - name: Reference File
  - name: SCIM
  - name: Segment
  - name: Segmentation Rules
  - name: Service
  - name: Spell Check
  - name: SubDomain
  - name: Supported Languages
  - name: Term Base
  - name: Translation
  - name: Translation Memory
  - name: User
  - name: Vendor
  - name: Webhook
  - name: Workflow Step
  - name: XML Assistant
paths:
  /api2/v1/projects/{projectUid}/jobs/{jobUid}:
    patch:
      tags:
        - Job
      summary: Patch job
      description: >

        This API call allows for partial updates to jobs, modifying specific
        fields without overwriting

        those not included in the update request.


        Differing from [Edit job](../job/edit-job), this call employs a PATCH
        method, updating only the provided fields

        without altering others. It's beneficial when editing a subset of
        supported fields is required.


        The call supports the editing of status, due date, and providers. When
        editing providers, it's essential to submit

        both the ID of the provider and its type (either VENDOR or USER).


        The response will provide a subset of information from [Get
        job](../job/get-job).
      operationId: patchPart
      parameters:
        - name: projectUid
          in: path
          description: Project UID
          required: true
          schema:
            type: string
        - name: jobUid
          in: path
          description: Job UID
          required: true
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/JobPartPatchSingleDtoV1'
        description: Subset of job fields to update
        required: true
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JobPartExtendedDtoV1'
        '400':
          description: Bad Request
        '401':
          description: Not authorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
        '405':
          description: Method not allowed
        '408':
          description: Timeout
        '410':
          description: Gone
        '415':
          description: Unsupported media type
        '429':
          description: Too many requests
        '500':
          description: Internal server error
        '501':
          description: Not implemented
components:
  schemas:
    JobPartPatchSingleDtoV1:
      type: object
      properties:
        dateDue:
          type: string
          format: date-time
        providers:
          type: array
          items:
            $ref: '#/components/schemas/ProviderReferenceV1'
        status:
          type: string
          enum:
            - NEW
            - ACCEPTED
            - DECLINED
            - REJECTED
            - DELIVERED
            - EMAILED
            - COMPLETED
            - CANCELLED
    JobPartExtendedDtoV1:
      type: object
      properties:
        beginIndex:
          type: integer
          format: int32
          description: Index of the first segment of this part within the original job
        continuous:
          type: boolean
          description: When true, this is a continuous job
        continuousJobInfo:
          $ref: '#/components/schemas/ContinuousJobInfoDtoV1'
        dateCreated:
          type: string
          format: date-time
          description: Date and time the job was created
        dateDue:
          type: string
          format: date-time
          description: Due date of the job; null if not set
        endIndex:
          type: integer
          format: int32
          description: Index of the last segment of this part within the original job
        filename:
          type: string
          description: Original filename of the job
        importStatus:
          $ref: '#/components/schemas/ImportStatusDtoV1'
        imported:
          type: boolean
          description: When true, the file has been imported successfully
        innerId:
          type: string
          description: >-
            InnerId is a sequential number of a job in a project. Jobs created
            from the same file share the same innerId across workflow steps.
        isParentJobSplit:
          type: boolean
          description: Whether the job originates from a split
        jobReference:
          $ref: '#/components/schemas/JobReferenceV1'
        lastWorkflowLevel:
          type: integer
          format: int32
          description: Highest workflow step level in the project
        originalFileDirectory:
          type: string
          description: Directory path of the original source file
        project:
          $ref: '#/components/schemas/A_reference_to_a_project'
        providers:
          type: array
          description: >-
            Providers assigned to the job; empty for callers without linguist
            visibility
          items:
            $ref: '#/components/schemas/ProviderReferenceV1'
        serverTaskId:
          type: string
          description: Identifier of the server-side import task
        sourceLang:
          type: string
          description: Source language code
        status:
          type: string
          description: Current status of the job
          enum:
            - NEW
            - ACCEPTED
            - DECLINED
            - REJECTED
            - DELIVERED
            - EMAILED
            - COMPLETED
            - CANCELLED
        targetLang:
          type: string
          description: Target language code
        uid:
          type: string
          description: Unique identifier used in API paths
        updateSourceDate:
          type: string
          format: date-time
          description: Date and time the source was last updated; null if never updated
        updateTargetDate:
          type: string
          format: date-time
          description: Date and time the target was last updated; null if never updated
        wordsCount:
          type: integer
          format: int32
          description: Number of words in the job
        workUnit:
          $ref: '#/components/schemas/ObjectReference'
        workflowLevel:
          type: integer
          format: int32
          description: Workflow step level of this job (1-based)
        workflowStep:
          $ref: '#/components/schemas/ProjectWorkflowStepReferenceV1'
    ProviderReferenceV1:
      type: object
      required:
        - type
      discriminator:
        propertyName: type
      properties:
        id:
          type: string
        type:
          type: string
        uid:
          type: string
          description: UID of the provider
          readOnly: true
    ContinuousJobInfoDtoV1:
      type: object
      properties:
        dateUpdated:
          type: string
          format: date-time
    ImportStatusDtoV1:
      type: object
      properties:
        errorMessage:
          type: string
        status:
          type: string
          enum:
            - RUNNING
            - ERROR
            - OK
    JobReferenceV1:
      type: object
      properties:
        filename:
          type: string
        uid:
          type: string
    A_reference_to_a_project:
      type: object
      properties:
        name:
          type: string
          description: Name of the project
        uid:
          type: string
          description: Unique identifier used in API paths
    ObjectReference:
      type: object
    ProjectWorkflowStepReferenceV1:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
        order:
          type: integer
          format: int32
        workflowLevel:
          type: integer
          format: int32
  securitySchemes:
    ApiToken:
      description: >-
        Get a token from `auth/login` [endpoint](#operation/login) and then pass
        it in the `Authorization` HTTP header in every subsequent API call. For
        more information visit our [help
        center](https://support.phrase.com/hc/en-us/articles/5709662181404-API-Authentication-TMS-#token-0-0).
      type: apiKey
      name: Authorization
      in: header
    OAuth2:
      description: >-
        A standard OAuth 2.0 authorization code flow. For more information visit
        our [help
        center](https://support.phrase.com/hc/en-us/articles/5709662181404-API-Authentication-TMS-#oauth-2-0-0-1).
      type: oauth2
      flows:
        authorizationCode:
          authorizationUrl: https://cloud.memsource.com/web/oauth/authorize
          tokenUrl: https://cloud.memsource.com/web/oauth/token
          scopes: {}

````