# Finalize a skill

Launch stage: Beta

`POST /api/2.1/unity-catalog/{name=skills/*}/finalize`

Finalizes a skill after its bundle is uploaded. This method reads SKILL.md
 through the Files API using the caller's authorization. Its YAML
 frontmatter must contain an agentskills.io-compliant `name` and a nonblank
 `description` within the configured UTF-8 byte limit. On success, it
 replaces `bundle_name` and `description`; refreshes `finalize_time`,
 `update_time`, and `updated_by`; and returns the updated skill. `comment` is
 preserved. Re-finalization uses the latest SKILL.md and is last-write-wins
 without an etag precondition. Validation failures do not change metadata.

 You must be the owner of the skill or have `READ_VOLUME` on it, plus
 `USE_CATALOG` on the parent catalog and `USE_SCHEMA` on the parent schema.

API scopes: unity-catalog

## Path parameters

- `name` (string, required)
  Full resource name of the skill.
   Format: `skills/{catalog}.{schema}.{skill}`.
   Each `{...}` component is capped at 255 characters individually.

## Returns

Returns the Skill object.

## Response

```json
{
  "name": "string",
  "bundle_name": "string",
  "description": "string",
  "etag": "string",
  "create_time": "string",
  "update_time": "string",
  "finalize_time": "string",
  "created_by": "string",
  "updated_by": "string",
  "effective_owner": "string",
  "metastore_id": "string",
  "comment": "string"
}
```