User

Get a User

Retrieves a specific user by their ID.

Licenses: Each user has exactly one license that determines their overall access level:

standard - Normal license with access to most of the Workpath platform
analyst - Power-user license with access to reports, insights, and summaries with filtering options
viewer - Read-only access; can view Goals but cannot create or update them

Roles: Users can have zero, one, or multiple roles that grant additional permissions:

super_admin - Administrator with full platform permissions including managing integrations
program_lead - Responsible for program roll-out, can manage users, teams, Goal Cycles, and assign Coaches
coach - Can be assigned to teams to support them, create and edit Goals (but not update progress/status)

Response includes:

User details (email, name, external_id, timestamps)
license - User's license type
roles - Array of additional roles (may be empty)
business_units - Business Units the user belongs to (may be empty)
deactivated_at - Timestamp if user is deactivated, null if active
last_active_at - Timestamp when user was last active, null if no activity has been recorded

Note: Deleted users are not accessible and will return a 404 error.

get/users/{id}

Request

Base URL: https://connect.workpath.com/api/v3
URL: https://connect.workpath.com/api/v3/users/{id}
Auth: HTTP bearer

Response

idinteger required

Unique identifier for the user.

emailstring email required

Email address of the user.

first_namestring required

First name of the user.

last_namestring required

Last name of the user.

namestring required

Full name of the user (first name + last name).

external_idstring nullable

External identifier for integration with other systems. Typically set via SAML or SCIM integration, often containing an ID from the identity provider (e.g., Entra ID object ID) or another internal employee ID. May be null if not set.

created_atstring date-time required

Timestamp when the user was created in ISO 8601 format.

updated_atstring date-time required

Timestamp when the user was last updated in ISO 8601 format.

deactivated_atstring date-time nullable

Timestamp when the user was deactivated in ISO 8601 format. null if the user is active.

last_active_atstring date-time nullable

Timestamp when the user was last active in ISO 8601 format. null if no activity has been recorded.

workpath_urlstring uri required

URL to view the user in the Workpath platform.

status'active' | 'invited' | 'deactivated' required

Mirrors the user status shown in the Workpath user settings UI (https://your-account.workpath.com/settings/users):

deactivated — deactivated_at is set.
invited — the user has an outstanding invitation and has not yet completed their first login.
active — otherwise.

Use status instead of deriving buckets from deactivated_at / last_active_at, so your reporting matches what end users see in Workpath.

license'standard' | 'analyst' | 'viewer' required

What the user can do in Workpath: standard users work with Goals, Key Results and Initiatives; viewer users can only view and follow them; analyst users additionally get access to reports.

rolesstring[] required

Additional responsibilities: super_admin users administer the customer's Workpath account, program_lead users run the goal-setting program, and coach users help teams draft their Goals. A user can have zero, one or several roles.

Example response

{
  "id": 5,
  "email": "thomas.weber@acme.com",
  "first_name": "Thomas",
  "last_name": "Weber",
  "name": "Thomas Weber",
  "external_id": "EMP-001",
  "created_at": "2025-01-15T10:30:00Z",
  "updated_at": "2026-01-20T14:45:00Z",
  "deactivated_at": null,
  "last_active_at": "2026-01-21T08:15:00Z",
  "workpath_url": "https://acme.workpath.com/users/5",
  "status": "active",
  "license": "standard",
  "roles": [
    "super_admin",
    "coach"
  ],
  "business_units": [
    {
      "id": 2,
      "name": "ACME EMEA"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.