eRS Actions icon

eRS Actions

Interact with the Ers App API

Actions29

Requirement → Create

AI-generated

Summary

Creates a new requirement in an eRS project with a time window, effort amount and unit, plus optional flexi range, comment and user-defined fields.

Inputs

  • authentication — Credential type: OAuth2 (recommended, default) or Access Token.
  • project_id (required) — ID of the project the requirement belongs to.
  • start_time (required) — Start date/time (yyyy-MM-ddThh:mm:00).
  • end_time (required) — End date/time, at least 15 minutes after start.
  • effort (required) — Effort value, 0 to 99999999.99 (step 0.01).
  • unit (required) — Effort unit: Hours (2, fixed) or Full Time Equivalent (4, uses the Administrator FTE calendar).
  • allow_multi_allocation — Whether multiple resource allocations are allowed (default false).
  • sync_to_booking — Whether custom fields sync to linked bookings (default false).
  • flexi_range_duration — Optional whole-number duration range for fulfilling the requirement.
  • flexi_range_unit — Unit for the flexi range: Hours (1) or Days (2, default).
  • mandatoryFields — Repeatable list of the requirement type's mandatory user-defined fields. Choose a field loaded from your account, then enter a value in the input type that matches the field (boolean, date, number, text, rich text, select, multi-select, ID or unit).
  • otherFields — Repeatable list of optional user-defined fields, with the same structure as mandatory fields.
  • comment — Free-text comment for the requirement.
  • requestOptions — Node settings for batching (items per batch, interval), ignoring SSL issues, proxy and timeout (default 10000 ms).

Output shape

Not visible in the source pack. The operation modules are stripped, so the return shape is unconfirmed. It is presumably the API response for the newly created requirement.

The source pack contains only signatures and no execute body for this operation, so the exact request and response format could not be verified.

Examples

Example 1: Request 40 hours of work on a project for next week.

Set project_id, start_time and end_time for the week, effort=40, unit=Hours.

Example 2: Create a requirement with a required custom field and a flexible schedule.

Fill in the core fields, add a Mandatory Fields entry for the custom field, set flexi_range_duration=3 and flexi_range_unit=Days.

Links

Discussion