---
title: "Update skill"
method: PUT
path: "/partner/app/{appId}/bizai/agent_config/skills/{skillId}"
tags: ["Configure — Agent Skills"]
---

# Update skill

`PUT /partner/app/{appId}/bizai/agent_config/skills/{skillId}`

## Request

- Base URL: `https://partner.gupshup.io`
- URL: `https://partner.gupshup.io/partner/app/{appId}/bizai/agent_config/skills/{skillId}`
- Auth: API key in header `Authorization`

Send only the fields being changed.

## Request body

- SkillUpdate
  - `title` string
  - `description` string
  - `skill` string

## Response `200`

Skill updated.

- Skill
  - `title` string
  - `description` string
  - `skill` string
  - `id` string: Meta resource id.
  - `channel` string
  - `created_at` integer
  - `metadata` object
  - `status` 'active' | 'pending_review' | 'blocked': A skill read straight after a write is normally `pending_review`.

## Other responses

- `400`: Rejected by Meta and forwarded unchanged.
- `401`: Missing, invalid, or foreign-app token. Raised by Partner Portal before any forwarding.
- `429`: Per-app rate limit exceeded. Retry after the 60-second window.

---

[API](https://skmtc.dev/gupshup/apis/partner-portal-meta-business-agent-bizai-api.md) - [All operations](https://skmtc.dev/gupshup/apis/partner-portal-meta-business-agent-bizai-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gupshup/apis/partner-portal-meta-business-agent-bizai-api/revisions/4c52185f2153?raw)