---
title: "Update a resource placeholder"
method: PATCH
path: "/resource-placeholders/{id}"
tags: ["Resource Placeholders"]
---

# Update a resource placeholder

`PATCH /resource-placeholders/{id}`

## Request

- Base URL: `https://www.ruddr.io/api/workspace`
- URL: `https://www.ruddr.io/api/workspace/resource-placeholders/{id}`
- Auth: HTTP bearer

## Path parameters

- `id` string, required

## Request body

- object
  - `name` string: The name of the resource placeholder (max 255 chars).
  - `isActive` boolean: Whether the resource placeholder is active.
  - `isBillable` boolean: Whether the resource placeholder is billable.
  - `rateCurrency` string, nullable: The currency code for the placeholder's rate. Can only use currencies available in the workspace.
  - `rate` number, nullable: The placeholder's rate.
  - `costCurrency` string, nullable: The currency code for the placeholder's cost. Can only use currencies available in the workspace.
  - `costPerHour` number, nullable: The placeholder's cost per hour.
  - `disciplineId` string, nullable: The discipline ID (`uuid`) for this placeholder.
  - `practiceId` string, nullable: The practice ID (`uuid`) for this placeholder.
  - `locationId` string, nullable: The location ID (`uuid`) for this placeholder.
  - `skillIds` string[]: A list of skill IDs (`uuid`) associated with this resource placeholder.

## Response `200`

200

- ResourcePlaceholder
  - `id` string: The unique identifier for the object.
  - `name` string: The name of the placeholder.
  - `isActive` boolean: Whether the placeholder is active.
  - `isBillable` boolean: Whether the placeholder is billable.
  - `rateCurrency` string, nullable: The currency code for the placeholder's billing rate. `null` when `isBillable` is `false`.
  - `rate` number, nullable: The placeholder's billing rate. `null` when `isBillable` is `false`.
  - `costCurrency` string, nullable: The currency code for the placeholder's cost rate. `null` when no cost rate is configured.
  - `costPerHour` number, nullable: The placeholder's cost per hour. `null` when no cost rate is configured.
  - `createdAt` string, date-time: The timestamp when the object was created.
  - `discipline` object, nullable: The discipline associated with this placeholder.
    - `id` string: The unique identifier for the object.
    - `name` string: The name of the discipline.
  - `practice` object, nullable: The practice associated with this placeholder.
    - `id` string: The unique identifier for the object.
    - `name` string: The name of the practice.
  - `location` object, nullable: The location associated with this placeholder.
    - `id` string: The unique identifier for the object.
    - `name` string: The name of the location.
  - `skills` object[]: The skills associated with this placeholder.
    - `id` string: The unique identifier for the object.
    - `name` string: The name of the skill.

## Other responses

- `400`: 400
- `403`: 403
- `404`: 404
- `409`: 409

---

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