PRproductive
Placeholder Usages

Update a placeholder usage

Changed on

Updates a placeholder usage. Only the provided attributes are modified — the target and field are set on create and cannot be changed. A different placeholder_id must still match the usage's field type.

patch/api/v2/placeholder_usages/{id}

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/{id}
  • Auth
    none declared

Path parameters

idstring required

The ID of the placeholder usage to update.

Request body

Example request

{
  "data": {
    "type": "placeholder_usages",
    "attributes": {
      "interval_enabled": true,
      "interval_value": 3,
      "interval_unit": "day",
      "interval_direction": "after",
      "skip_weekends": true
    }
  }
}

Response

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

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

    • info

      added the non-success response with the status

  • f11a8740641aRevision changes
    • 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 request property //

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