---
title: "Update job custom fields"
method: PATCH
path: "/v1/jobs/{jobId}/custom-fields"
tags: ["Jobs"]
---

# Update job custom fields

`PATCH /v1/jobs/{jobId}/custom-fields`

## Request

- Base URL: `https://api.workwing.io`
- URL: `https://api.workwing.io/v1/jobs/{jobId}/custom-fields`
- Auth: HTTP bearer

Update custom field values on an existing job using field_key slugs. Send `null` to clear a field; that deletes the stored value and needs the `delete:custom_field_values` scope.

## Path parameters

- `jobId` string, uuid, required

## Headers

- `Idempotency-Key` string, required

## Request body

- object
  - `custom_fields` object, required

## Response `200`

Default Response

- object
  - `data` object, required
    - `custom_fields` object, required: Custom field values keyed by field_key. Only fields that hold a value are listed.
  - `meta` object, required
    - `request_id` string, required
    - `timestamp` string, date-time, required

---

[API](https://skmtc.dev/workwing/apis/workwing-api.md) · [All operations](https://skmtc.dev/workwing/apis/workwing-api/llms.txt) · [OpenAPI document](https://skmtc.dev/workwing/apis/workwing-api/revisions/54bb14368a35?raw)