Skip to main content
POST
/
resource-placeholders
Create a resource placeholder
curl --request POST \
  --url https://www.ruddr.io/api/workspace/resource-placeholders \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "isActive": true,
  "isBillable": true,
  "rateCurrency": "<string>",
  "rate": 123,
  "costCurrency": "<string>",
  "costPerHour": 123,
  "disciplineId": "<string>",
  "locationId": "<string>",
  "practiceId": "<string>",
  "skillIds": [
    "<string>"
  ]
}
'
{
  "id": "2e7f3a91-c845-4d62-b8f1-5a9d0e3c7b24",
  "name": "Senior Consultant",
  "isActive": true,
  "isBillable": true,
  "rateCurrency": "USD",
  "rate": 185,
  "costCurrency": "USD",
  "costPerHour": 95,
  "createdAt": "2026-01-08T14:33:21.094Z",
  "discipline": {
    "id": "3a8f1d2c-e947-4b06-9f13-c2d5e7a80b41",
    "name": "Technical Consulting"
  },
  "location": {
    "id": "9f4c2e71-3b8d-4a15-b6f2-d1e9c7a50384",
    "name": "North America"
  },
  "practice": {
    "id": "89c60b34-cca3-4b66-85d0-7b21e8e03c94",
    "name": "Implementation Services"
  },
  "skills": [
    {
      "id": "cc1128f7-7cac-4707-aeab-fe347b784abc",
      "name": "Salesforce"
    },
    {
      "id": "354ba2a2-b67b-4278-8d25-9ec2aa37daea",
      "name": "Consulting"
    }
  ]
}
A generic role-based slot used to plan staffing needs before assigning specific members.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
name
string
required

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

The currency code for the placeholder's rate. Will default to the workspace's default currency if not provided. Can only use currencies available in the workspace.

​
rate
number<float>

The placeholder's rate.

​
costCurrency
string

The currency code for the placeholder's cost. Will default to the workspace's default currency if not provided. Can only use currencies available in the workspace.

​
costPerHour
number<float>

The placeholder's cost per hour.

​
disciplineId
string

The discipline ID (uuid) for this placeholder.

​
locationId
string

The location ID (uuid) for this placeholder.

​
practiceId
string

The practice ID (uuid) for this placeholder.

​
skillIds
string[]

A list of skill IDs (uuid) associated with this resource placeholder.

Response

200

​
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 | null

The currency code for the placeholder's billing rate. null when isBillable is false.

​
rate
number | null

The placeholder's billing rate. null when isBillable is false.

​
costCurrency
string | null

The currency code for the placeholder's cost rate. null when no cost rate is configured.

​
costPerHour
number | null

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

The discipline associated with this placeholder.

​
location
object

The location associated with this placeholder.

​
practice
object

The practice associated with this placeholder.

​
skills
object[]

The skills associated with this placeholder.