Attention: Update User

Change an Attention user’s name, teams, role or deals access.

Tool ID: attention_update_user

Run this action

Use the TypeScript SDK for one call. Use ctx.tools.execute(...) inside a Play for durable calls, scheduled calls, or CSV processing.

import { Deepline } from 'deepline';

const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
  'attention_update_user',
  {
    "userId": "user_123"
  },
);

console.log(result.toolResponse.raw);

CLI

deepline tools execute attention_update_user --input '{
  "userId": "user_123"
}' --json

Example response

The SDK returns this shape at result.toolResponse.raw. The example values illustrate the response.

{
  "data": {
    "data": {
      "uuid": "uuid_123",
      "email": "jane.doe@example.com",
      "firstName": "Jane"
    }
  }
}

Use deepline describe attention_update_user --json for the latest machine-readable contract.

Input reference

Updates an existing user’s information in the organization. You can modify the user’s name, email, team assignment, and role. Requires proper permissions to update user details.

Name	Type	Required	Default	Details
`payload.userId`	`string`	Yes	—	UUID of the user to update
`payload.firstName`	`string`	No	—	—
`payload.lastName`	`string`	No	—	—
`payload.password`	`string`	No	—	—
`payload.botName`	`string`	No	—	—
`payload.dealsEnabled`	`boolean`	No	—	—
`payload.teamUUIDsToRemove`	`array`	No	—	—
`payload.teamsToAdd`	`array`	No	—	—
`payload.roleUUID`	`string`	No	—	The UUID of the role assigned to the user.
`payload.seat_type`	`"listener" \| "recording"`	No	`"recording"`	The type of seat assigned to the user. Allowed: `listener`, `recording`.

Output reference

Standard tool result payload.

Name	Type	Required	Default	Details
`result.data`	`object`	Yes	—	Provider response payload.
`result.data.data`	`object`	No	—	—
`result.data.data.uuid`	`string`	No	—	The unique identifier of the user.
`result.data.data.email`	`string`	No	—	The email address of the user.
`result.data.data.firstName`	`string`	No	—	The first name of the user.
`result.data.data.lastName`	`string`	No	—	The last name of the user.
`result.data.data.createdAt`	`string`	No	—	The date and time the user was created.
`result.data.data.deletedAt`	`string`	No	—	The date and time the user was deactivated.
`result.data.data.transcriptLang`	`string`	No	—	The preferred transcript language for the user.
`result.data.data.joinOutsideHostMeetings`	`boolean`	No	—	Indicates if the user can join meetings outside their host organization.
`result.data.data.realTimeCapabilities`	`boolean`	No	—	Indicates if the user has real-time transcription capabilities.
`result.data.data.settings`	`object`	No	—	—
`result.data.data.settings.realTimeCapabilitiesOFF`	`boolean`	No	—	—
`result.data.data.settings.autoCalculateCRMFields`	`boolean`	No	—	—
`result.data.data.settings.joinWhenIAmHostAndAlone`	`boolean`	No	—	—
`result.data.data.settings.joinWhenIAmHostWithPeers`	`boolean`	No	—	—
`result.data.data.settings.joinWhenPeerIsHost`	`boolean`	No	—	—
`result.data.data.settings.joinWhenUnlicensedPeerIsHost`	`boolean`	No	—	—
`result.data.data.settings.dealsEnabled`	`boolean`	No	—	—
`result.data.data.botName`	`string`	No	—	The name of the bot associated with the user.
`result.data.data.botImageURL`	`string`	No	—	The URL of the bot’s profile image.
`result.data.data.primaryTeamUUID`	`string`	No	—	The UUID of the user’s primary team.
`result.data.data.organizationRoleUUID`	`string`	No	—	The UUID of the user’s role in the organization.
`result.data.data.roles`	`array`	No	—	A list of roles assigned to the user.
`result.data.data.roles[].uuid`	`string`	No	—	—
`result.data.data.roles[].name`	`string`	No	—	—
`result.data.data.roles[].type`	`string`	No	—	—
`result.data.data.showReferralScreen`	`boolean`	No	—	Whether the user is shown a referral screen.
`result.data.data.seatType`	`string`	No	—	The type of seat assigned to the user.
`result.data.data.teams`	`array`	No	—	A list of teams assigned to the user.
`result.data.data.teams[].uuid`	`string`	No	—	Unique identifier of the team
`result.data.data.teams[].name`	`string`	No	—	Name of the team
`result.data.data.teams[].phrases`	`array`	No	—	List of keywords or phrases associated with the team
`result.data.data.teams[].slackConnection`	`object`	No	—	Represents the Slack integration details for a team
`result.data.data.teams[].slackConnection.id`	`string`	No	—	Slack connection identifier
`result.data.data.teams[].slackConnection.info`	`object`	No	—	Information about a connected Slack team
`result.data.data.teams[].slackConnection.info.id`	`string`	No	—	Slack team identifier
`result.data.data.teams[].slackConnection.info.name`	`string`	No	—	Name of the Slack team
`result.data.data.teams[].domain`	`string`	No	—	Domain associated with the team
`result.data.data.teams[].organizerJoinInternalMeetings`	`boolean`	No	—	Whether team organizers can join internal meetings
`result.data.data.teams[].consentEmailEnabled`	`boolean`	No	—	Whether email consent is enabled for the team
`result.data.data.teams[].parentTeamUUID`	`string`	No	—	UUID of the parent team if this team is part of a hierarchy
`result.data.data.teams[].organizationUUID`	`string`	No	—	UUID of the organization this team belongs to
`result.data.data.teams[].children`	`array`	No	—	List of child teams if this team has a hierarchical structure
`result.meta`	`object`	No	—	Additional response metadata (status, paging).

Deepline cost

Pricing model: fixed (per call).
Estimated Deepline credits: 0 per pricing unit.
Provider-native pricing may still exist outside Deepline credit billing.

​Run this action

​CLI

​Example response

​Input reference

​Output reference

​Deepline cost

​Related documentation

Run this action

CLI

Example response

Input reference

Output reference

Deepline cost

Related documentation