Users

Manage user accounts and profiles. Standard users can view profiles and update their own account. Administrative endpoints allow creating, archiving, and managing other user accounts.

All endpoints require authentication via X-API-Key header and the appropriate scope.

---

User Object

{
  "id": "user_456",
  "email": "jane@example.com",
  "emails": [
    {
      "address": "jane@example.com",
      "verified": true
    }
  ],
  "name": "Jane Smith",
  "username": "janesmith",
  "profile": {
    "firstName": "Jane",
    "lastName": "Smith",
    "bio": "ML Engineer",
    "timezone": "America/New_York"
  },
  "role": "admin",
  "roles": ["admin"],
  "status": "active",
  "organizationId": "org_xyz",
  "organization": {
    "id": "org_xyz",
    "name": "Acme Corp"
  },
  "avatarUrl": "https://cdn.strongly.ai/avatars/user_456.png",
  "lastLogin": "2025-02-01T14:22:00Z",
  "lastLoginAt": "2025-02-01T14:22:00Z",
  "createdAt": "2024-06-15T10:30:00Z",
  "updatedAt": "2025-02-01T14:22:00Z"
}

---

GET /api/v1/users

List all users in the organization. Returns safe fields only (sensitive data is excluded).

Scope: users:read

Query Parameters

Parameter	Type	Required	Description
search	string	No	Search by name, email, or username
archived	boolean	No	Filter by archived status
active	boolean	No	Filter by active status
limit	integer	No	Number of results to return (default: 20)
offset	integer	No	Number of results to skip (default: 0)
sort	string	No	Sort field and direction, e.g. createdAt:desc

Response 200 OK

{
  "count": 25,
  "limit": 20,
  "offset": 0,
  "users": [
    {
      "id": "user_456",
      "email": "jane@example.com",
      "name": "Jane Smith",
      "username": "janesmith",
      "role": "admin",
      "status": "active",
      "organizationId": "org_xyz",
      "avatarUrl": "https://cdn.strongly.ai/avatars/user_456.png",
      "lastLoginAt": "2025-02-01T14:22:00Z",
      "createdAt": "2024-06-15T10:30:00Z"
    }
  ]
}

---

GET /api/v1/users/me

Get the currently authenticated user's full profile, including organization information.

Scope: users:read

Response 200 OK

{
  "id": "user_456",
  "email": "jane@example.com",
  "emails": [
    {
      "address": "jane@example.com",
      "verified": true
    }
  ],
  "name": "Jane Smith",
  "username": "janesmith",
  "profile": {
    "firstName": "Jane",
    "lastName": "Smith",
    "bio": "ML Engineer",
    "timezone": "America/New_York"
  },
  "role": "admin",
  "roles": ["admin"],
  "status": "active",
  "organizationId": "org_xyz",
  "organization": {
    "id": "org_xyz",
    "name": "Acme Corp",
    "plan": "enterprise",
    "status": "active"
  },
  "avatarUrl": "https://cdn.strongly.ai/avatars/user_456.png",
  "lastLoginAt": "2025-02-01T14:22:00Z",
  "createdAt": "2024-06-15T10:30:00Z",
  "updatedAt": "2025-02-01T14:22:00Z"
}

---

PUT /api/v1/users/me

Update the currently authenticated user's own profile.

Scope: users:write

Request Body

{
  "name": "Jane M. Smith",
  "username": "janemsmith",
  "profile": {
    "firstName": "Jane",
    "lastName": "Smith",
    "bio": "Senior ML Engineer",
    "timezone": "America/Chicago"
  }
}

Field	Type	Required	Description
name	string	No	Display name
username	string	No	Username (must be unique)
profile	object	No	Profile fields (firstName, lastName, bio, timezone)

Response 200 OK

Returns the updated User object.

---

GET /api/v1/users/:id

Get a user by ID. Returns safe fields only (sensitive data is excluded).

Scope: users:read

Path Parameters

Parameter	Type	Required	Description
id	string	Yes	User ID

Response 200 OK

{
  "id": "user_789",
  "email": "bob@example.com",
  "name": "Bob Johnson",
  "username": "bobjohnson",
  "role": "user",
  "status": "active",
  "organizationId": "org_xyz",
  "avatarUrl": "https://cdn.strongly.ai/avatars/user_789.png",
  "lastLoginAt": "2025-01-30T09:15:00Z",
  "createdAt": "2024-08-20T14:00:00Z"
}

---

POST /api/v1/users

Create a new user account. Requires administrator privileges.

Scope: users:admin

Request Body

{
  "email": "newuser@example.com",
  "name": "New User",
  "role": "user",
  "password": "SecureP@ssw0rd!"
}

Field	Type	Required	Description
email	string	Yes	User email address (must be unique)
name	string	Yes	Display name
role	string	No	User role: user, admin (default: user)
password	string	No	Initial password (a temporary password is generated if omitted)

Response 201 Created

{
  "userId": "user_new001",
  "email": "newuser@example.com",
  "temporaryPassword": false
}

---

PUT /api/v1/users/:id

Update a user account. Requires administrator privileges.

Scope: users:admin

Path Parameters

Parameter	Type	Required	Description
id	string	Yes	User ID

Request Body

{
  "name": "Updated Name",
  "role": "admin",
  "status": "active"
}

Field	Type	Required	Description
name	string	No	Display name
role	string	No	User role: user, admin
status	string	No	Account status: active, suspended

Response 200 OK

Returns the updated User object.

---

GET /api/v1/users/:id/assets

Get a summary of all resources owned by a user. Useful before archiving to understand the impact.

Scope: users:admin

Path Parameters

Parameter	Type	Required	Description
id	string	Yes	User ID

Response 200 OK

{
  "userId": "user_789",
  "userName": "Jane Smith",
  "userEmail": "jane@example.com",
  "organizationId": "org_xyz",
  "isSSO": false,
  "assets": {
    "apps": 3,
    "workspaces": 2,
    "workflows": 5,
    "projects": 1,
    "dataVolumes": 0,
    "addons": 1,
    "datasources": 2,
    "prompts": 8,
    "abTests": 0,
    "routers": 1,
    "aiModels": 4,
    "guardrails": 2,
    "mlModels": 0,
    "total": 29
  }
}

---

POST /api/v1/users/:id/archive

Archive a user account with asset handling. Archived users cannot log in. Admin chooses how to handle owned resources: transfer to another user, transfer to org admin, delete, or leave as-is.

Scope: users:admin

Path Parameters

Parameter	Type	Required	Description
id	string	Yes	User ID

Request Body

Parameter	Type	Required	Description
assetAction	string	No	transfer, transfer-to-admin, delete, or leave-as-is. Defaults to leave-as-is
transferToUserId	string	Conditional	Required when assetAction is transfer. Must be an active user in the same organization

Response 200 OK

{
  "archived": true,
  "assetAction": "transfer-to-admin",
  "assetResult": {
    "success": true,
    "transferred": {
      "apps": 3,
      "workflows": 5,
      "total": 29
    },
    "transferredTo": "admin_user_id"
  },
  "userId": "user_789",
  "userName": "Jane Smith"
}

For full details on asset handling options and directory sync, see User Lifecycle & Offboarding.

---

POST /api/v1/users/:id/unarchive

Unarchive a previously archived user. Reactivates the account. Resources transferred or deleted during archival are not restored.

Scope: users:admin

Path Parameters

Parameter	Type	Required	Description
id	string	Yes	User ID

Response 200 OK

{
  "archived": false,
  "userId": "user_789"
}

---

POST /api/v1/users/:id/reset-password

Reset a user's password. Sends a password reset email or generates a temporary password. Requires administrator privileges.

Scope: users:admin

Path Parameters

Parameter	Type	Required	Description
id	string	Yes	User ID

Response 200 OK

{
  "message": "Password reset initiated",
  "userId": "user_789",
  "resetEmailSent": true
}