/Activity ActionsPOST

Activity Actions

Perform status transitions and movements on activities in bulk.

1 — Excel file

Each row = one API call.

Submit to OFS

Upload an Excel file.

Fields

activityIdrequiredinteger

OFS Activity ID to act on.

actionrequiredenum

Action to perform.

startcompletecancelsuspendnotDonedelayenroutemove
timedatetime

When the action occurred in resource time zone. Defaults to now.

delayMinutesinteger

[delay only] Minutes to extend the activity.

newDatedate

[move only] New scheduled date.

newResourceIdstring

[move only] Reassign to this resource.

newPositionstring

[move only] Position in route: beginning | end | {number}

Notes

  • ·start → pending/enroute → started
  • ·complete → started → completed
  • ·cancel → pending/enroute → cancelled
  • ·suspend → started/pending → pending (removes from ordered route)
  • ·notDone → started → notdone
  • ·enroute → pending (ordered, first in route) → enroute
  • ·delay → Extends started activity. Requires delayMinutes.
  • ·move → Reschedule/reassign. Requires at least one of: newDate, newResourceId, newPosition.