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

# actor.assignment.read · OpenVibe.Services

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

# `actor.assignment.read`

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.

Read one node of your assignment tree and its children with GET /api/v1/assignments/:id (actor.assignment@1): the hand-off, who started it, its mode and reply, the agent and task it runs as, its level and effective level, the root's budget and the state. Only the person whose work it is can read it; another person gets the same 404 as a node that does not exist.

- Owner: actor (token audience `openvibe.actor`)
- Version: 1.0
- Status: active
- Visibility: public
- Resource constraints: owner
- Quota class: actor-read
- Permissions: actor:assignments:read
- Input: [common.no-body@1](/docs/contracts/common.no-body)
- Output: actor.assignment-tree@1
- Events: —
- Implemented by: - `GET /api/v1/assignments/:id`

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