> ## Documentation Index
> Fetch the complete documentation index at: https://deepline.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Attention: Update Team

> Rename an Attention team or move it under another parent team. Includes SDK V2 guidance, input constraints, response fields, and Deepline credit cost.

Rename an Attention team or move it under another parent team.

> [!NOTE]
>
> Tool ID: `attention_update_team`

## 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.

```ts theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
import { Deepline } from 'deepline';

const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
  'attention_update_team',
  {
    "teamId": "team_123"
  },
);

console.log(result.toolResponse.raw);
```

### CLI

```bash theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
deepline tools execute attention_update_team --input '{
  "teamId": "team_123"
}' --json
```

## Example response

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

```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
{
  "data": {
    "data": {
      "uuid": "uuid_123",
      "name": "Example",
      "phrases": [
        "example"
      ]
    }
  }
}
```

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

## Input reference

Updates an existing team's information. You can modify the team's name and parent team assignment. This operation can be used to restructure the team hierarchy within the organization.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `payload.teamId` | `string` | Yes | — | UUID of the team to update |
| `payload.name` | `string` | No | — | — |
| `payload.parentTeamUUID` | `string` | No | — | — |

<details>
  <summary>Show raw input schema</summary>

  ### Input JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "Updates an existing team's information. You can modify the team's name and parent team assignment. This operation can be used to restructure the team hierarchy within the organization.",
    "properties": {
      "teamId": {
        "type": "string",
        "description": "UUID of the team to update"
      },
      "name": {
        "type": "string"
      },
      "parentTeamUUID": {
        "type": "string"
      }
    },
    "required": [
      "teamId"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Output reference

Standard tool result payload.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `result.data` | `object` | Yes | — | Provider response payload. |
| `result.data.data` | `object` | No | — | Represents a team in the system with its properties and hierarchical structure |
| `result.data.data.uuid` | `string` | No | — | Unique identifier of the team |
| `result.data.data.name` | `string` | No | — | Name of the team |
| `result.data.data.phrases` | `array` | No | — | List of keywords or phrases associated with the team |
| `result.data.data.slackConnection` | `object` | No | — | Represents the Slack integration details for a team |
| `result.data.data.slackConnection.id` | `string` | No | — | Slack connection identifier |
| `result.data.data.slackConnection.info` | `object` | No | — | Information about a connected Slack team |
| `result.data.data.slackConnection.info.id` | `string` | No | — | Slack team identifier |
| `result.data.data.slackConnection.info.name` | `string` | No | — | Name of the Slack team |
| `result.data.data.domain` | `string` | No | — | Domain associated with the team |
| `result.data.data.organizerJoinInternalMeetings` | `boolean` | No | — | Whether team organizers can join internal meetings |
| `result.data.data.consentEmailEnabled` | `boolean` | No | — | Whether email consent is enabled for the team |
| `result.data.data.parentTeamUUID` | `string` | No | — | UUID of the parent team if this team is part of a hierarchy |
| `result.data.data.organizationUUID` | `string` | No | — | UUID of the organization this team belongs to |
| `result.data.data.children` | `array` | No | — | List of child teams if this team has a hierarchical structure |
| `result.meta` | `object` | No | — | Additional response metadata (status, paging). |

<details>
  <summary>Show raw output schema</summary>

  ### Output JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "Standard tool result payload.",
    "properties": {
      "data": {
        "type": "object",
        "description": "Provider response payload.",
        "properties": {
          "data": {
            "type": "object",
            "description": "Represents a team in the system with its properties and hierarchical structure",
            "properties": {
              "uuid": {
                "type": "string",
                "description": "Unique identifier of the team"
              },
              "name": {
                "type": "string",
                "description": "Name of the team"
              },
              "phrases": {
                "type": "array",
                "description": "List of keywords or phrases associated with the team",
                "items": {
                  "type": "string"
                }
              },
              "slackConnection": {
                "type": "object",
                "description": "Represents the Slack integration details for a team",
                "properties": {
                  "id": {
                    "type": "string",
                    "description": "Slack connection identifier"
                  },
                  "info": {
                    "type": "object",
                    "description": "Information about a connected Slack team",
                    "properties": {
                      "id": {
                        "type": "string",
                        "description": "Slack team identifier"
                      },
                      "name": {
                        "type": "string",
                        "description": "Name of the Slack team"
                      }
                    },
                    "additionalProperties": false
                  }
                },
                "additionalProperties": false
              },
              "domain": {
                "type": "string",
                "description": "Domain associated with the team"
              },
              "organizerJoinInternalMeetings": {
                "type": "boolean",
                "description": "Whether team organizers can join internal meetings"
              },
              "consentEmailEnabled": {
                "type": "boolean",
                "description": "Whether email consent is enabled for the team"
              },
              "parentTeamUUID": {
                "type": "string",
                "description": "UUID of the parent team if this team is part of a hierarchy"
              },
              "organizationUUID": {
                "type": "string",
                "description": "UUID of the organization this team belongs to"
              },
              "children": {
                "type": "array",
                "description": "List of child teams if this team has a hierarchical structure",
                "items": {
                  "type": "object",
                  "description": "Recursive OpenAPI schema reference #/components/schemas/Team.",
                  "additionalProperties": true
                }
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "meta": {
        "type": "object",
        "description": "Additional response metadata (status, paging).",
        "additionalProperties": true
      }
    },
    "required": [
      "data"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Deepline cost

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

## Related documentation

* [Attention provider guide](https://deepline.com/docs/providers/attention/guide.md)
* [SDK V2 quickstart](https://deepline.com/docs/sdk-v2/quickstart.md)
* [SDK reference](https://deepline.com/docs/sdk-v2/sdk-reference.md)
* [Run tools across a CSV](https://deepline.com/docs/sdk-v2/batch-csv.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.