Retrieve a placeholder

Operation ID: getPlaceholder

Group: PSA › Placeholders

Open in the interactive reference

GET /psa/placeholders/{id}

Read-only: Reads and returns; changes nothing.

Retrieves a placeholder.

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.
id path string yes The unique identifier of the placeholder you want to retrieve. Example: "3f2a91c7-5d84-4b1e-9c60-8a7e2d4f0b13".

Response

200 Success

Under data (getPlaceholderOutput):

Field Type Required Description
id string yes The unique identifier for the placeholder. Example: "3f2a91c7-5d84-4b1e-9c60-8a7e2d4f0b13".
name string yes The display name of the placeholder, for example 'Unassigned Backend Engineer'. Unique within the tenant. Example: "Unassigned Backend Engineer".
weeklyWorkingHours decimal 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 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"
  },
  "diagnostics": [
    {
      "code": "<code>",
      "message": "<message>",
      "severity": "error",
      "path": [
        "<path>"
      ],
      "details": "<details>"
    }
  ]
}

Errors

Code Status
NOT_FOUND 400

Statuses