PRproductive
Placeholders

Create a placeholder

Changed on

Creates a placeholder on a template project. Requires name, category, type, color, icon, and project_id — the project must be a template. The type determines what the placeholder resolves to when a project is created from the template: a person or a date.

Create a person placeholder

{
  "data": {
    "type": "placeholders",
    "attributes": {
      "name": "Project Manager",
      "category": "project",
      "type": "person",
      "color": "electric",
      "icon": "icon-cowboy-hat-filled",
      "project_id": 7388870
    }
  }
}

Create a date placeholder

{
  "data": {
    "type": "placeholders",
    "attributes": {
      "name": "Kickoff date",
      "category": "project",
      "type": "date",
      "color": "canary",
      "icon": "icon-calendar",
      "project_id": 7388870
    }
  }
}
post/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

Request body

Example request

{
  "data": {
    "type": "placeholders",
    "attributes": {
      "name": "Senior Developer",
      "category": "project",
      "type": "person",
      "color": "electric",
      "icon": "icon-cowboy-hat-filled",
      "project_id": 7388870
    }
  }
}

Response

Single 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": []
}

Changes

  • fa3060fd0144Revision changes
    • warning

      added the new bad_decimal_format enum value to the // response property for the response status

    • warning

      added the new non_finite_number enum value to the // response property for the response status

    • warning

      added the new null_bytes_in_params enum value to the // response property for the response 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

    • 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.