Productive icon

Productive

Interact with the Productive API

Actions508

Placeholders → Get placeholders

AI-generated

Summary

Retrieve a list of placeholders from the Productive API, optionally applying filters, pagination, and sorting to control which placeholders are returned and their order.

Inputs

  • Return All — Choose whether to return all placeholders or limit the results.
  • Limit — The maximum number of placeholders to return when not returning all.
  • Page Number — The page number to retrieve, used with pagination when not returning all.
  • Page Size — The number of placeholders to return per page when using pagination (max 200).
  • Filter Query String — A raw filter query string that overrides other filters; follows Productive API syntax for field filtering.
  • Filters — One or more filters applied to placeholder fields (Category, Created At, ID, Name, Project ID, Type) with operations like contains, equals, greater than, etc.; ignored if Filter Query String is set.
  • Sort By — The field to sort the placeholders by (Category, ID, Name, Type, or None).
  • Sort Order — The sort direction: ascending or descending.

Output shape

A list of placeholder objects, each representing a single placeholder record retrieved from the Productive API.

Results support pagination when 'Return All' is false, based on 'Page Number' and 'Page Size'. Filtering via raw query string disables other filter options. Sorting applies if specified. Errors during execution may be returned per item if 'Continue On Fail' is enabled.

Examples

Example 1: Retrieve first 30 placeholders sorted by name ascending

Set Return All to false, Page Number to 1, Page Size to 30, Sort By to 'Name', Sort Order to 'Ascending'.

Example 2: Retrieve all placeholders whose 'Category' equals 'Task'

Set Return All to true and apply a filter where Filter Field is 'Category', Operation is 'Equals', and Value is 'Task'.

Discussion