PRproductive
Placeholder Usages

Get placeholder usages

Changed on

Returns a paginated list of placeholder usages — bindings of placeholders to fields on template tasks and todos.

get/api/v2/placeholder_usages

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/placeholder_usages
  • Auth
    none declared

Query parameters

OR

Filter parameter for querying placeholder usages.

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

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

Response

Collection placeholder usage

Example response

{
  "data": [
    {
      "id": "199",
      "type": "placeholder_usages",
      "attributes": {
        "id": 199,
        "target_id": 7388879,
        "target_type": "Ticket",
        "field": "assignee",
        "placeholder_id": 88,
        "interval_value": null,
        "interval_unit": null,
        "interval_direction": null,
        "skip_weekends": false,
        "interval_enabled": false,
        "created_at": "2026-09-02T11:48:44.135+02:00",
        "updated_at": "2026-09-02T11:48:44.135+02:00"
      },
      "relationships": {
        "placeholder": {
          "data": {
            "type": "placeholders",
            "id": "88"
          }
        },
        "task": {
          "data": {
            "type": "tasks",
            "id": "7388879"
          }
        }
      }
    }
  ],
  "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
    • breaking

      removed the enum value -interval_enabled from the property items/ of the query request parameter sort

    • breaking

      removed the enum value interval_enabled from the property items/ of the query request parameter sort

    • breaking

      the /// response's property type changed from string to no type for status

    • breaking

      the /// response's property type changed from string to no type for status

    • breaking

      the /// response's property type changed from integer to no type for status

    • warning

      deleted the header request parameter X-Organization-Id

    • warning

      removed the optional property /// from the response with the status

    • warning

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

    • warning

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

    • info

      added the enum value Ticket to the property oneOf[subschema #2: Filter placeholder usage]/target_type/oneOf[subschema #1: Operation]/contains of the query request parameter filter

    • info

      added the enum value Ticket to the property oneOf[subschema #2: Filter placeholder usage]/target_type/oneOf[subschema #1: Operation]/eq of the query request parameter filter

    • info

      added the enum value Ticket to the property oneOf[subschema #2: Filter placeholder usage]/target_type/oneOf[subschema #1: Operation]/not_contain of the query request parameter filter

    • info

      added the enum value Ticket to the property oneOf[subschema #2: Filter placeholder usage]/target_type/oneOf[subschema #1: Operation]/not_eq of the query request parameter filter

    • info

      added the enum value Ticket to the property oneOf[subschema #2: Filter placeholder usage]/target_type/oneOf[subschema #2: Target Type]/ of the query request parameter filter

    • info

      added the enum value Todo to the property oneOf[subschema #2: Filter placeholder usage]/target_type/oneOf[subschema #1: Operation]/contains of the query request parameter filter

    • info

      added the enum value Todo to the property oneOf[subschema #2: Filter placeholder usage]/target_type/oneOf[subschema #1: Operation]/eq of the query request parameter filter

    • info

      added the enum value Todo to the property oneOf[subschema #2: Filter placeholder usage]/target_type/oneOf[subschema #1: Operation]/not_contain of the query request parameter filter

    • info

      added the enum value Todo to the property oneOf[subschema #2: Filter placeholder usage]/target_type/oneOf[subschema #1: Operation]/not_eq of the query request parameter filter

    • info

      added the enum value Todo to the property oneOf[subschema #2: Filter placeholder usage]/target_type/oneOf[subschema #2: Target Type]/ of the query request parameter filter

    • 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

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

    • info

      added subschema #2 to the /// response property anyOf list for the response status

    • info

      added subschema #2 to the /// response property anyOf list for the response status

    • info

      added subschema #2 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

      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

    • info

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

    • info

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

    • info

      removed the after enum value from the /// response property for the response status

    • info

      removed the before enum value from the /// response property for the response status

    • info

      removed the day enum value from the /// response property for the response status

    • info

      removed the month enum value from the /// response property for the response status

    • info

      removed the week enum value from the /// response property for the response status

    • info

      removed the year enum value from the /// response property for the response status

    This list may be incomplete.