> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ariacompute.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Add Skill Version - POST /v1/workspaces/:workspace_id/skills/:skill_id/versions

> Append a version to a skill via POST /v1/workspaces/:workspace_id/skills/:skill_id/versions. Minimum role contributor.

Append a version to a skill, recording resource files, trigger boundaries, execution steps, and validation rules.

## Endpoint

```http theme={null}
POST /v1/workspaces/:workspace_id/skills/:skill_id/versions
```

## Authentication

`Authorization: Bearer <jwt>` or `X-API-Key <sk_...>`. Minimum role: **contributor**.

## Path parameters

**workspace\_id** `string` *required*

Workspace id.

**skill\_id** `string` *required*

Skill id.

## Request body

**version** `string`

Version label (e.g. `v1`).

**resource\_files** `string[]`

Resource file list.

**trigger\_boundaries** `string`

Trigger boundary description.

**exec\_steps** `string[]`

Execution steps.

**validation\_rules** `string[]`

Validation rules.

## Response

**id** `string`

Version id (`skv_...`).

**skill\_id** `string`

Owning skill id.

**version** `string`

Version label.

**resource\_files** `string[]`

Resource files.

**trigger\_boundaries** `string`

Trigger boundaries.

**exec\_steps** `string[]`

Execution steps.

**validation\_rules** `string[]`

Validation rules.

**created\_at** `string`

Creation time (RFC3339).

## Example

```bash cURL theme={null}
curl -X POST https://memo.ariacompute.com/v1/workspaces/ws_01a2b3c4d5e6/skills/skill_01a2b3c4d5e6/versions \
  -H "Authorization: Bearer <jwt>" \
  -H "Content-Type: application/json" \
  -d '{"version":"v1","exec_steps":["fetch","summarize"],"validation_rules":["not_empty"]}'
```

```json 200 theme={null}
{
  "id": "skv_01a2b3c4d5e6",
  "skill_id": "skill_01a2b3c4d5e6",
  "version": "v1",
  "resource_files": [],
  "trigger_boundaries": "",
  "exec_steps": ["fetch", "summarize"],
  "validation_rules": ["not_empty"],
  "created_at": "2026-10-12T10:05:00Z"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.