List placeholders
Operation ID: placeholders
Group: PSA › Placeholders
Open in the interactive reference
GET /psa/placeholders
Read-only: Reads and returns; changes nothing.
Lists placeholders. The list includes only active placeholders.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
Api-Version |
header | string · v1 | yes | The API version this request targets, named by its public identifier. Required on every request; omitting it, or naming a version this company does not have, is answered with 400. This document describes version v1. |
Query surface
id— filter by eq, ne, gt, gte, lt, lte, in, notIn, between, likename— filter by eq, ne, gt, gte, lt, lte, in, notIn, between, likelastModifiedDate— filter by eq, ne, gt, gte, lt, lte, in, notIn, between- Orderable: name, lastModifiedDate
- Selectable: id, name, weeklyWorkingHours, lastModifiedDate
page[size]— Page sizepage[cursor]— Opaque continuation cursor
Response
200 Success
Under data, an array of placeholdersRow:
| Field | Type | Required | Filter | Sort | Description |
|---|---|---|---|---|---|
id |
string | no | Exact (eq, ne), Range (gt, gte, lt, lte, between), Any of (in, notIn), Pattern (like) |
no | The unique identifier for the placeholder. Example: "3f2a91c7-5d84-4b1e-9c60-8a7e2d4f0b13". |
name |
string | no | Exact (eq, ne), Range (gt, gte, lt, lte, between), Any of (in, notIn), Pattern (like) |
yes | The display name of the placeholder, for example 'Unassigned Backend Engineer'. Unique within the tenant. Example: "Unassigned Backend Engineer". |
weeklyWorkingHours |
decimal | null | no | no | no | The weekly working hours used for planning, as a non-negative number of hours, for example 40.00. Absent when none was set. Example: "40.00". |
lastModifiedDate |
date-time | null | no | Exact (eq, ne), Range (gt, gte, lt, lte, between), Any of (in, notIn) |
yes | The date and time the placeholder last changed, in UTC. Format YYYY-MM-DDTHH:mm:ss.sssZ. Example: "2026-08-14T09:12:33.184Z". |
{
"data": [
{
"id": "3f2a91c7-5d84-4b1e-9c60-8a7e2d4f0b13",
"name": "Unassigned Backend Engineer",
"weeklyWorkingHours": "40.00",
"lastModifiedDate": "2026-08-14T09:12:33.184Z"
}
],
"pagination": {
"hasMore": true,
"nextCursor": "<nextCursor>"
}
}
Statuses
400— Invalid request or business failure401— The request carries no valid access token.403— Not authorized404— Not found429— Too many requests from this client address. The response has no body and noRetry-Afterheader.500— Internal server error