PRproductive
Placeholders

Get placeholders

Changed on

Returns a paginated list of placeholders — named person or date slots defined on template projects. Supports filtering by name, category, type, and project, or by the project whose tasks and todos use the placeholder (usage_project_id).

get/api/v2/placeholders

Request

  • Base URL
    https://developer.productive.io (the document declares no server; this is the origin it was published from)
  • URL
    https://developer.productive.io/api/v2/placeholders
  • Auth
    none declared

Query parameters

OR

Filter parameter for querying placeholders.

{
  "0": {
    "id": {
      "eq": "123"
    }
  },
  "$op": "and"
}
sortstring[]

Sort order for placeholder list results. Accepts one or more field names, comma-separated; prefix with - for descending. --branch descriptions

Response

Collection placeholder

Example response

{
  "data": [
    {
      "id": "88",
      "type": "placeholders",
      "attributes": {
        "name": "Employee",
        "category": "project",
        "color": "electric",
        "icon": "icon-cowboy-hat-filled",
        "type": "person",
        "created_at": "2026-09-02T11:48:32.010+02:00",
        "updated_at": "2026-09-02T11:48:42.251+02:00"
      },
      "relationships": {
        "organization": {
          "data": {
            "type": "organizations",
            "id": "109"
          }
        },
        "project": {
          "data": {
            "type": "projects",
            "id": "7388870"
          }
        }
      }
    }
  ],
  "included": [],
  "meta": {
    "current_page": 1,
    "total_pages": 1,
    "total_count": 2,
    "page_size": 30,
    "max_page_size": 200
  }
}

Changes

  • fa3060fd0144Revision changes
    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

  • f11a8740641aRevision changes
    • warning

      deleted the header request parameter X-Organization-Id

    • info

      added to the /// response property anyOf list for the response status

    • info

      added to the /// response property anyOf list for the response status

    • info

      removed subschema #1: Single data from the /// response property anyOf list for the response status

    • info

      removed subschema #1: Single data from the /// response property anyOf list for the response status

    • info

      the response property ///// became required for the status

    • info

      the response property ////// became required for the status

    • info

      the response property ///// became required for the status

    • info

      the response property ////// became required for the status

    This list may be incomplete.