---
title: "actor.skill.run · OpenVibe.Services"
canonical: "https://openvibe.services/docs/capabilities/actor.skill.run"
updated: null
---

# actor.skill.run · OpenVibe.Services

HTML: [actor.skill.run · OpenVibe.Services](https://openvibe.services/docs/capabilities/actor.skill.run)

# `actor.skill.run`

Generated at 2026-11-13 06:25:48 UTC from [`openvibe-contracts v0.419.0`](https://github.com/OpenVibers/OpenVibe.Contracts/tree/v0.419.0) and [`openvibe-sdk v0.161.0`](https://github.com/OpenVibers/OpenVibe.SDK/tree/v0.161.0).

Grantable to apps: request it for an app on its project page. Network approves it only inside the project's allowance.

Start a catalogue skill as this person (plan 2026-11-09 §7): POST /api/v1/runs with the skill key, its input and a choice (cheapest, balanced, best, fastest, private). The run is an ordinary Actor task with the skill's instructions pinned to it, so editing the catalogue later never changes a task already under way. A skill that needs a sandbox runner cannot start here, and the person still approves what it does.

- Owner: actor (token audience `openvibe.actor`)
- Version: 1.0
- Status: active
- Visibility: public
- Resource constraints: owner, project
- Quota class: actor-task
- Permissions: actor:tasks:create
- Input: [actor.skill-run-request@1](/docs/contracts/actor.skill-run-request)
- Output: actor.skill-run-result@1
- Events: —
- Implemented by: - `POST /api/v1/runs`

[These routes in the API explorer](/docs/api/actor#cap-actor.skill.run)