---
title: "Update resources matching a filter"
method: PATCH
path: "/v1/resources"
tags: ["Workflows"]
---

# Update resources matching a filter

`PATCH /v1/resources`

## Request

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

Update every resource matching the query filters. To update one resource, use `PATCH /v1/resources/{resourceId}`.

Requires an `Idempotency-Key` header.

## Headers

- `Idempotency-Key` string, required

## Request body

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

## Response `200`

Updated resource(s)

- object: Updated resource(s)
  - `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

---

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