Skip to content

ulams users

Generated from front/cli (ulams schema)

Upload avatar.

Kind: write. Stability: stable. MCP tool: users_avatar_add. Scopes: users:write.

Endpoints: POST /api/admin/users/{id}/avatar.

Flag Type Required Description
--id (positional) integer yes
--avatar string avatar (path of a local file)
Terminal window
# Upload avatar
ulams users avatar-add 1 --json
Input JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"id": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"avatar": {
"type": "string",
"description": "avatar (path of a local file)"
}
},
"required": [
"id"
],
"additionalProperties": {}
}

Delete avatar.

Kind: destructive (idempotent). Stability: stable. MCP tool: users_avatar_delete. Scopes: users:write.

Endpoints: DELETE /api/admin/users/{id}/avatar.

Flag Type Required Description
--id (positional) integer yes
Terminal window
# Delete avatar
ulams users avatar-delete 1 --json
Input JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"id": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
}
},
"required": [
"id"
],
"additionalProperties": {}
}

Create user.

Kind: write. Stability: stable. MCP tool: users_create. Scopes: users:write.

Endpoints: POST /api/admin/users.

Flag Type Required Description
--email string
--id integer
Terminal window
# Create user
ulams users create --json
Input JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"email": {
"type": "string"
},
"id": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
}
},
"additionalProperties": {}
}

Delete user.

Kind: destructive (idempotent). Stability: stable. MCP tool: users_delete. Scopes: users:write.

Endpoints: DELETE /api/admin/users/{id}.

Flag Type Required Description
--id (positional) integer yes
Terminal window
# Delete user
ulams users delete 1 --json
Input JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"id": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
}
},
"required": [
"id"
],
"additionalProperties": {}
}

Get user.

Kind: read (idempotent). Stability: stable. MCP tool: users_get. Scopes: users:read.

Endpoints: GET /api/admin/users/{id}.

Flag Type Required Description
--id (positional) integer yes
Terminal window
# Get user
ulams users get 1 --json
Input JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"id": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
}
},
"required": [
"id"
],
"additionalProperties": {}
}

Add single user interest.

Kind: write. Stability: stable. MCP tool: users_interests_add. Scopes: users:write.

Endpoints: POST /api/admin/users/{id}/interests.

Flag Type Required Description
--id (positional) integer yes
--interest-id integer yes Id of category to be added
Terminal window
# Add single user interest
ulams users interests-add 1 --interest-id text --json
Input JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"id": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"interest_id": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "Id of category to be added"
}
},
"required": [
"id",
"interest_id"
],
"additionalProperties": {}
}

Add single user interest.

Kind: destructive (idempotent). Stability: stable. MCP tool: users_interests_delete. Scopes: users:write.

Endpoints: DELETE /api/admin/users/{id}/interests/{interest_id}.

Flag Type Required Description
--id (positional) integer yes
--interest-id (positional) integer yes
Terminal window
# Add single user interest
ulams users interests-delete 1 1 --json
Input JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"id": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"interest_id": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
}
},
"required": [
"id",
"interest_id"
],
"additionalProperties": {}
}

Get user interests.

Kind: read (idempotent). Stability: stable. MCP tool: users_interests_list. Scopes: users:read.

Endpoints: GET /api/admin/users/{id}/interests.

Flag Type Required Description
--id (positional) integer yes
Terminal window
# Get user interests
ulams users interests-list 1 --json
Input JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"id": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
}
},
"required": [
"id"
],
"additionalProperties": {}
}

Set user interests.

Kind: write (idempotent). Stability: stable. MCP tool: users_interests_set. Scopes: users:write.

Endpoints: PUT /api/admin/users/{id}/interests.

Flag Type Required Description
--id (positional) integer yes
--interests array Ids of categories to be set
Terminal window
# Set user interests
ulams users interests-set 1 --json
Input JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"id": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"interests": {
"type": "array",
"items": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"description": "Ids of categories to be set"
}
},
"required": [
"id"
],
"additionalProperties": {}
}

Get users.

Kind: read (idempotent). Stability: stable. MCP tool: users_list. Scopes: users:read.

Endpoints: GET /api/admin/users.

Flag Type Required Description
--page integer
--per-page integer
--search string will search through first_name, last_name and email
--role string user role
--status boolean will check if user is_active
--onboarding boolean will check if user completed onboarding
--from string users created after this date
--to string users created before this date
--gt-last-login-day integer users last login greater equal then X days
--lt-last-login-day integer users last login less or equal then X days
Terminal window
# Get users
ulams users list --json
Input JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"page": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"per_page": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"search": {
"type": "string",
"description": "will search through first_name, last_name and email"
},
"role": {
"type": "string",
"description": "user role"
},
"status": {
"type": "boolean",
"description": "will check if user is_active"
},
"onboarding": {
"type": "boolean",
"description": "will check if user completed onboarding"
},
"from": {
"type": "string",
"description": "users created after this date"
},
"to": {
"type": "string",
"description": "users created before this date"
},
"gt_last_login_day": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "users last login greater equal then X days"
},
"lt_last_login_day": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "users last login less or equal then X days"
}
},
"additionalProperties": {}
}

Partial Update User (will only change sent fields).

Kind: write. Stability: stable. MCP tool: users_patch. Scopes: users:write.

Endpoints: PATCH /api/admin/user/{id}.

Flag Type Required Description
--id (positional) integer yes
--email string
Terminal window
# Partial Update User (will only change sent fields)
ulams users patch 1 --json
Input JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"id": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"email": {
"type": "string"
}
},
"required": [
"id"
],
"additionalProperties": {}
}

Get user settings.

Kind: read (idempotent). Stability: stable. MCP tool: users_settings_list. Scopes: users:read.

Endpoints: GET /api/admin/users/{id}/settings.

Flag Type Required Description
--id (positional) integer yes
Terminal window
# Get user settings
ulams users settings-list 1 --json
Input JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"id": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
}
},
"required": [
"id"
],
"additionalProperties": {}
}

Set user setting (removes settings not sent).

Kind: write (idempotent). Stability: stable. MCP tool: users_settings_set. Scopes: users:write.

Endpoints: PUT /api/admin/users/{id}/settings.

Flag Type Required Description
--id (positional) integer yes
--body unknown Request body (JSON)
Terminal window
# Set user setting (removes settings not sent)
ulams users settings-set 1 --json
Input JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"id": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"body": {
"description": "Request body (JSON)"
}
},
"required": [
"id"
],
"additionalProperties": {}
}

Update user setting(s) without changing other settings.

Kind: write. Stability: stable. MCP tool: users_settings_update. Scopes: users:write.

Endpoints: PATCH /api/admin/users/{id}/settings.

Flag Type Required Description
--id (positional) integer yes
--body unknown Request body (JSON)
Terminal window
# Update user setting(s) without changing other settings
ulams users settings-update 1 --json
Input JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"id": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"body": {
"description": "Request body (JSON)"
}
},
"required": [
"id"
],
"additionalProperties": {}
}

Update/Replace user data (will overwrite unset fields with nulls).

Kind: write (idempotent). Stability: stable. MCP tool: users_update. Scopes: users:write.

Endpoints: PUT /api/admin/user/{id}.

Flag Type Required Description
--id (positional) integer yes
--email string
Terminal window
# Update/Replace user data (will overwrite unset fields with nulls)
ulams users update 1 --json
Input JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"id": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"email": {
"type": "string"
}
},
"required": [
"id"
],
"additionalProperties": {}
}