Productive icon

Productive

Interact with the Productive API

Actions508

Placeholder Usages → Create a placeholder usage

AI-generated

Summary

Create a new placeholder usage by specifying the placeholder ID along with optional linkage to a task or todo item, and configure related fields such as field name, interval settings, and weekend skipping behavior.

Inputs

  • Placeholder ID (required) — Numeric identifier of the placeholder to use (required).
  • Task ID — String identifier of the associated task (optional).
  • Todo ID — String identifier of the associated todo item (optional).
  • Field — Name of the field to assign the placeholder usage to; valid options include assignee, subscriber, due_date, start_date (optional).
  • Interval Enabled — Boolean flag to enable interval-based offset adjustments (optional).
  • Interval Value — Number indicating the amount of the interval to apply (optional).
  • Interval Unit — Unit of the interval such as day, week, month, or year (optional).
  • Interval Direction — Direction of the interval adjustment relative to a reference point; valid values are before or after (optional).
  • Skip Weekends — Boolean flag indicating whether to skip weekends when applying intervals (optional).

Output shape

a single record representing the created placeholder usage

Returns the details of the newly created placeholder usage object. Error handling returns failure details in the output if 'Continue On Fail' is enabled.

Examples

Example 1: Create a placeholder usage linked to a task with a 2-week interval before a due date, skipping weekends.

Specify the placeholder ID, provide the task ID, set field to 'due_date', enable interval with value 2, unit 'week', direction 'before', and enable skip weekends.

Discussion