Placeholders

Placeholders are unnamed resource slots used in capacity planning before a specific person is assigned. They represent a role, skill, or headcount requirement on a project — allowing teams to schedule capacity without committing to a named individual.

Placeholders can be converted to real person assignments once staffing decisions are made.

Attributes

category string
Response Request Parameter `filter` Parameter `sort` Enum

The category of this placeholder, indicating the context in which it is used (e.g. project).

Enum Values (1 value)

  • project
    Project
color string
Response Request

The color identifier used to visually represent this placeholder.
created_at string
Response Parameter `filter`

Timestamp when this placeholder was created.
icon string
Response Request

The icon identifier used to visually represent this placeholder.
id integer
Response Parameter `filter` Parameter `sort`

The unique identifier of this placeholder.
name string
Response Request Parameter `filter` Parameter `sort`

The display name of this placeholder (e.g. Frontend Developer).
organization organization
Response

The organization this placeholder belongs to.
project project
Response

The project this placeholder is scoped to, or null if it is organization-wide.
project_id integer
Request Parameter `filter`

ID of the project this placeholder is scoped to, or null if it is organization-wide.
query string
Parameter `filter`

A text search query to filter placeholders by name.
type string
Response Request Parameter `filter` Parameter `sort` Enum

The type of placeholder, either person or date.

Enum Values (2 values)

  • person
    Person
  • date
    Date
updated_at string
Response

Timestamp when this placeholder was last updated.
usage_project_id integer
Parameter `filter`

Filter placeholders to those used in tasks or todos within the specified project.

Operations

GET /api/v2/placeholders
Get placeholders
POST /api/v2/placeholders
Create a placeholder
DELETE /api/v2/placeholders/{id}
Deletes a placeholder
GET /api/v2/placeholders/{id}
Gets a placeholder
PATCH /api/v2/placeholders/{id}
Update a placeholder