# Set the current skill version

Set the existing skill version as the current version. Request to use the current version number for concurrent verification to avoid overwriting the updates just completed by other callers.

```text
POST https://moi.matrixorigin.cn/newmoi/workspaces/{workspace_id}/skills/{skill_id}/versions/{version}/current
```

## Before you call

First [query skill version](list-skill-versions.md) to get the target version number, and [query skill details](get-skill.md) to get the current version number]. Prepare the personal access token, target workspace ID, and skill ID that have access to the target workspace.

The example below uses:

- `$AI_STUDIO_API_KEY`: The actual personal access token, passed through the `X-API-Key` Header.
- `$WORKSPACE_ID`: Target workspace ID, passed through `X-Workspace-ID` Header.
- `$SKILL_ID`: Skill ID.

## Request example

```bash
curl -X POST "https://moi.matrixorigin.cn/newmoi/workspaces/$WORKSPACE_ID/skills/$SKILL_ID/versions/2/current" \
  -H "X-API-Key: $AI_STUDIO_API_KEY" \
  -H "X-Workspace-ID: $WORKSPACE_ID" \
  -H 'Content-Type: application/json' \
  -d '{
    "expected_current_version": 1
  }'
```

## Path parameters

| Parameters | Type | Is it required | Description |
| --- | --- | --- | --- |
| `workspace_id` | string | Yes | The current workspace ID. |
| `skill_id` | string | Yes | Skill ID. |
| `version` | integer | Yes | Positive integer version number to be set to the current version. |

## Query parameters

| Parameters | Type | Is it required | Description |
| --- | --- | --- | --- |
| `skill_workspace_id` | string | No | The workspace to which the skill belongs; can only be the current workspace or `system`. System skills are read-only. |

## Request body

| Field | Type | Is it required | Description |
| --- | --- | --- | --- |
| `expected_current_version` | integer | Yes | The current version number read must be a positive integer. When the target version is not yet the current version, the service will use it for concurrent verification. |

## Successful response

On success, `200` and the switched skill definition are returned.

```json
{
  "code": 0,
  "data": {
    "id": "skill_01",
    "workspace_id": "ws_01",
    "name": "摘要技能",
    "status": "active",
    "version": 2,
    "updated_at": "2026-01-03T10:00:00Z"
  }
}
```

The response fields are as follows.

| Field | Type | Description |
| --- | --- | --- |
| `code` | integer | `0` on success. |
| `data.id` | string | Skill ID and workspace. |
| `data.workspace_id` | string | Skill ID and workspace. |
| `data.name` | string | Basic information about current skills. |
| `data.status` | string | Basic information about current skills. |
| `data.version` | integer | The current version number after switching. |
| `data.updated_at` | string | Switching time, using RFC 3339 format. |

## Error response

```json
{
  "code": 4,
  "message": "<错误信息>"
}
```

### Common HTTP errors

```{list-table}
:header-rows: 1
:widths: 12 22 32 34

* - HTTP status code
  - error code
  - Common causes
  - Recommended actions
* - `400`
  - `2`（`INVALID_ARGUMENT`）
  - The version number or `expected_current_version` is not a positive integer, or the path/workspace range is invalid.
  - Use a valid version number after reading the version list.
* - `401`
  - `6`（`UNAUTHENTICATED`）
  - Lack of valid identity credentials.
  - Check API Key.
* - `403`
  - `5`（`PERMISSION_DENIED`）
  - The current identity does not have permission to update skills.
  - Check workspace authorization.
* - `403`
  - `7`（`FORBIDDEN`）
  - Specify system skills as read-only.
  - Create a manageable copy of the skill in the current workspace.
* - `404`
  - `3`（`NOT_FOUND`）
  - Skill or target version does not exist.
  - Check skill ID, version number and `skill_workspace_id`.
* - `409`
  - `4`（`ALREADY_EXISTS`）
  - The current version has changed and `expected_current_version` no longer matches.
  - Reread the skill details or version list before submitting.
* - `503`
  - `15`（`UNAVAILABLE`）
  - Skill services or authorized dependencies are temporarily unavailable.
  - Try again later.
```

## Follow-up operations

After setting, [Query skill version](list-skill-versions.md) or [Query skill details](get-skill.md) to confirm the current version.