/Create / Update UserPUT

Create / Update User

Creates or replaces a user account in OFS. Each Excel row is one user (PUT by login).

1 — Excel file

Each row = one API call.

Submit to OFS

Upload an Excel file.

Fields

loginrequiredstring

Unique user login / username (path parameter). Must be unique in OFS.

namerequiredstring

Full name of the user.

languagerequiredstring

Preferred language code (e.g. en, fr, es).

timeZonerequiredstring

OFS time zone name (e.g. Eastern, Arizona) or IANA name (e.g. America/New_York).

userTyperequiredstring

User type label as configured in OFS (controls access).

resourcesrequiredstring

Comma-separated resource IDs assigned to this user. At least one required.

passwordstring

Password for local login policy. Ignored for SAML authentication.

passwordTemporaryenum

If true, user is prompted to change password on first login.

truefalse
statusenum

Account status. Defaults to active.

activeinactive
mainResourceIdstring

Primary resource for this user (field personnel). If previously assigned to another user, that association is removed.

organizationalUnitstring

Bucket or organizational unit ID (for bucket/org-unit roles).

dateFormatenum

Date display preference.

dd/mm/yymm/dd/yydd.mm.yyyyyy/mm/dd
timeFormatenum

Time display preference.

12-hour24-hour
weekStartenum

First day of the week.

sundaymondaytuesdaywednesdaythursdayfridaysaturdaydefault
selfAssignmentenum

If true, user can assign activities to themselves.

truefalse

Notes

  • ·login becomes the URL path — it is NOT sent in the request body.
  • ·PUT creates the user if not found, or fully replaces the existing user.
  • ·resources: enter multiple resource IDs separated by commas (e.g. res1,res2).
  • ·If mainResourceId was previously assigned to another user, that link is removed automatically.
  • ·password is only used for 'local password storage' login policy — ignored for SAML/SSO.