# `bird whatsapp agents skills update`

## Usage

```bash
bird whatsapp agents skills update <number-id> <skill-id> [flags]
```

## Description

Update one of an agent's skills

Change one skill the agent on this WhatsApp number holds. Omitted fields are left alone, and the change reaches WhatsApp before this returns.

Build the request from flags, a JSON WhatsAppAgentSkillUpdate body via --body-file ("-" reads
stdin), or both — a flag overrides the matching body field. Run --example to
print a ready-to-edit body, or --dry-run to print the resolved request without
sending it.

## Examples

```bash
# print the body shape (no credentials needed)
bird whatsapp agents skills update --example

# the body it prints:
```

```json
{
  "skill": "Ask for the order number. Tell the contact the cancellation window is 48 hours from ordering."
}
```

## Options

#### Request

| Name                | Description                                                  |
| ------------------- | ------------------------------------------------------------ |
| `--body-file`       | Read the JSON request body from this file; "-" reads stdin   |
| `--example`         | Print a complete example request body, then exit             |
| `--dry-run`         | Print the resolved request without sending it, then exit     |
| `--idempotency-key` | Deduplication key; a retry with the same key won't act twice |

#### Options

| Name                | Description                                                                                        |
| ------------------- | -------------------------------------------------------------------------------------------------- |
| `--title`           | A short handle for the skill, in lowercase letters, digits and hyphens. Omit to leave it as it is. |
| `--description`     | When the agent should use this skill. Omit to leave it as it is.                                   |
| `--skill`           | What the agent does when the skill applies. Omit to leave it as it is.                             |
| `--response-schema` | Print the fields this command returns, then exit                                                   |

## Related

| Name                                                                                      | Description                     |
| ----------------------------------------------------------------------------------------- | ------------------------------- |
| [`bird whatsapp agents skills create`](/docs/cli/reference/whatsapp-agents-skills-create) | Add a skill to an agent         |
| [`bird whatsapp agents skills delete`](/docs/cli/reference/whatsapp-agents-skills-delete) | Remove one of an agent's skills |
| [`bird whatsapp agents skills get`](/docs/cli/reference/whatsapp-agents-skills-get)       | Get one of an agent's skills    |
| [`bird whatsapp agents skills list`](/docs/cli/reference/whatsapp-agents-skills-list)     | List an agent's skills          |

## Related resources

- [Should I use a Bird SDK or call the API directly?](/explained/platform/should-i-use-an-sdk-or-call-the-api-directly) (answer)
- [Build your first integration](/learn/paths/integration) (course)
- [Send your first email](/docs/get-started/send-your-first-email) (docs)

[Get an implementation brief](/learn/workspace?topic=api-basics)