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

# run.session.read · OpenVibe.Services

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

# `run.session.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 your own browser sessions: GET /api/v1/sessions (run.session-list-result@1), GET /api/v1/sessions/:id (run.session@1: state, where it runs, task\_id, timings, desk-seconds) and GET /api/v1/sessions/:id/still (the desk's newest frame as a small JPEG, at most once a second, or the curtain picture while Curtain now is up). Never another person's: anyone else gets 404, a signed-out visitor included.

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

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