---
title: "Update a skill"
method: PUT
path: "/skills/{action_id}"
tags: ["Skills"]
---

# Update a skill

`PUT /skills/{action_id}`

## Request

- Base URL: `https://be.graph8.com/api/v1`
- URL: `https://be.graph8.com/api/v1/skills/{action_id}`
- Auth: HTTP bearer

Update an existing skill. Pre-flight GET enforces the action is
actually a skill (not a workflow/script) before forwarding the PUT.

## Path parameters

- `action_id` string, required: Skill action_id.

## Headers

- `Authorization` string, nullable
- `X-Target-Org-Id` string, nullable

## Request body

- object: Partial update (voice ActionUpdateRequest).

## Response `200`

Successful Response

- object

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/graph8/apis/graph8-developer-api.md) · [All operations](https://skmtc.dev/graph8/apis/graph8-developer-api/llms.txt) · [OpenAPI document](https://skmtc.dev/graph8/apis/graph8-developer-api/revisions/2e7cfa0ca921?raw)