---
title: "Update job"
method: PUT
path: "/jobs-api/v3/projects/{projectId}/jobs/{translationJobUid}"
tags: ["Jobs"]
---

# Update job

`PUT /jobs-api/v3/projects/{projectId}/jobs/{translationJobUid}`

This updates the attributes of the job, such as job name, description, due date, and reference number. The API works in a replace-all fashion. Fields, that are not passed, will be overwritten with empty values.

## Path parameters

- `projectId` string, required
- `translationJobUid` string, required

## Request body

- UpdateJobRequest — The payload to use when updating a job.
  - `jobName` string — The name of the job. It must be unique within the Smartling project. `jobName` is **required**.
  - `description` string — The description of the job.
  - `dueDate` string, date-time — The date by which the job is requested to be completed.
  - `referenceNumber` string — Customer specific number/identifier for the job.
  - `callbackUrl` string — The URL for Smartling to invoke when the job is completed.
  - `callbackMethod` string — The HTTP method to call (GET|POST) when invoking the `callbackUrl`.
  - `customFields` CustomFieldBasicRequest[]
    - `fieldUid` string — Custom field unique identifier.
    - `fieldValue` string — Custom field value.

## Response `200`

OK

- DetailedJobResponse
  - `response` object, required
    - `code` 'SUCCESS', required — Indicates whether the response was successful or what error has occured.
    - `data` object
      - `callbackMethod` string — The http method (GET|POST) to use when Smartling invokes the callback URL upon job completion.
      - `callbackUrl` string — The callback URL to invoke when a job is completed.
      - `createdByUserUid` string — The userUid of whom created the job.
      - `createdDate` string, date-time — The UTC value of the date the job was created.
      - `description` string — The description of the job.
      - `dueDate` string, date-time — The UTC value of the due date for the job.
      - `firstCompletedDate` string, date-time — The UTC value of when the job was first completed.
      - `firstAuthorizedDate` string, date-time — The UTC value of when the job was first authorized.
      - `jobName` string — The name of the job.
      - `jobNumber` string — The account level unique number of the job. Consist of unique short prefix and sequence number.
      - `priority` integer — The account level unique integer value that shows the priority of the job compared to others.
      - `referenceNumber` string — Some text to reference job in external systems.
      - `jobStatus` 'DRAFT' | 'AWAITING_AUTHORIZATION' | 'IN_PROGRESS' | 'COMPLETED' | 'CANCELLED' | 'CLOSED' | 'DELETED' — The status of the job.
      - `lastCompletedDate` string, date-time — The UTC value of when the job was last completed.
      - `lastAuthorizedDate` string, date-time — The UTC value of when the job was last authorized.
      - `modifiedByUserUid` string — The userUid of whom last modified the job.
      - `modifiedDate` string, date-time — The UTC value of the date the job was modified.
      - `sourceFiles` SourceFile[] — List of source files of the job. Limited to **300** unordered entries. To get all of the job files use [List files within job](/#operation/getJobFilesList) API
        - `data` object
          - `name` string — File name
          - `uri` string — File uri
          - `fileUid` string — File uid
      - `targetLocaleIds` string[] — The array of localeIds for the job.
      - `customFields` CustomFieldBasicResponse[]
        - `fieldUid` string — Custom field unique identifier.
        - `fieldName` string — Custom field name.
        - `fieldValue` string — Custom field value.
      - `translationJobUid` string — The unique identifier created for the job.
      - `issues` IssuesCount
        - `sourceIssuesCount` integer — Source inssues count.
        - `translationIssuesCount` integer — Translation inssues count.

## Other responses

- `400` — Validation error on updating a job
- `401` — Provided credentials are not valid.
- `404` — Job not found error
- `429` — Too many simultaneous API requests.
- `500` — Unexpected error

---

[API](https://skmtc.net/smartling/apis/smartling-rest-api-reference.md) · [All operations](https://skmtc.net/smartling/apis/smartling-rest-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/smartling/smartling-rest-api-reference/versions/2a73d11e9b98/schema)