---
title: "Update a resource"
method: PATCH
path: "/v1/resources/{resourceId}"
tags: ["Resources"]
---

# Update a resource

`PATCH /v1/resources/{resourceId}`

## Request

- Base URL: `https://api.workwing.io`
- URL: `https://api.workwing.io/v1/resources/{resourceId}`
- Auth: HTTP bearer

Update one resource. Send only the fields to change; the response is the updated resource.

Requires an `Idempotency-Key` header.

## Path parameters

- `resourceId` string, uuid, required

## Query parameters

- `select` string

## Headers

- `Idempotency-Key` string, required

## Request body

- object
  - `is_available` boolean
  - `email` string, email
  - `tags` string[]

## Response `200`

The updated resource

- object: The updated resource
  - `data` object
    - `id` string, uuid
    - `user_id` string, uuid: The user this resource represents (required on create)
    - `display_name` string, nullable: Display name (auto-populated from the linked user)
    - `email` string, email, nullable
    - `is_available` boolean, nullable: Whether the resource is available for assignments
    - `availability_status` 'T_AVAILABLE' | 'T_ON_BREAK' | 'T_UNAVAILABLE'
    - `break_started_at` string, date-time, nullable
    - `break_reason` string, nullable
    - `current_latitude` number, nullable: The resource's live position, for your own team only: do not show it to customers. For a customer-facing tracking page use GET /v1/jobs/{jobId}/tracking.
    - `current_longitude` number, nullable
    - `location_accuracy` number, nullable: Reported accuracy of the live position, in metres
    - `location_updated_at` string, date-time, nullable
    - `tags` string[], nullable: Resource tags/skills
    - `created_by_user_id` string, uuid, nullable
    - `created_at` string, date-time, nullable
    - `updated_at` string, date-time, nullable
  - `meta` object
    - `request_id` string
    - `timestamp` string, date-time

## Other responses

- `400`: Default Response
- `401`: Default Response
- `404`: Default Response

---

[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)