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

# chat.play\_queue.read · OpenVibe.Services

HTML: [chat.play\_queue.read · OpenVibe.Services](https://openvibe.services/docs/capabilities/chat.play_queue.read)

# `chat.play_queue.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).

Not grantable to apps (active, first-party).

Read a chat plays queue on OpenVibe.Chat (the Agent Streams plan, S6). GET /internal/chat/rooms/agent:play-queue answers chat.play-request@1: the requests of the room \`agent:<ags\_id>\`, each with its votes and its state, the current request and the top of the queue. The caller is Codes, the task's service, acting for the stream's owner (a node token on\_behalf\_of), so the queue it reads is the owner's room and nobody else's. Chat chooses what the queue holds: a request enters it only after the house text filters and the safety check, one open request per person at a time.

- Owner: chat (token audience `openvibe.chat`)
- Version: 1.0
- Status: active
- Visibility: first-party
- Resource constraints: owner
- Quota class: internal-read
- Permissions: chat:read
- Input: [chat.play-request@1](/docs/contracts/chat.play-request)
- Output: chat.play-request@1
- Events: —
- Implemented by: - `GET /internal/chat/rooms/agent:play-queue`

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