# API Reference

Source: <https://everruns.com/docs/api/operations/tags/rooms/>

[Docs](https://everruns.com/docs/)/[API reference](https://everruns.com/docs/api/)/[Sessions & workspaces](https://everruns.com/docs/api/groups/sessions-workspaces/)

Management API

# Rooms API

Manage execution sessions and rooms, and their files, tasks, storage, databases and managed sandboxes.

## Browse endpoints

Support All levels (all)

### Rooms

[GET**List the org's rooms, most recently active first**`/v1/rooms`Preview](https://everruns.com/docs/api/operations/list_rooms/)[POST**Create a room where people and agents talk**`/v1/rooms`Preview](https://everruns.com/docs/api/operations/create_room/)[GET**Read the change feed of every room in the org, in order**`/v1/rooms/events`Preview](https://everruns.com/docs/api/operations/list_org_room_events/)[GET**Get a room**`/v1/rooms/{room_id}`Preview](https://everruns.com/docs/api/operations/get_room/)[PATCH**Change a room's name, topic or settings**`/v1/rooms/{room_id}`Preview](https://everruns.com/docs/api/operations/update_room/)[POST**Archive a room (or bring it back with archived=false)**`/v1/rooms/{room_id}/archive`Preview](https://everruns.com/docs/api/operations/archive_room/)[GET**Read a room's change feed**`/v1/rooms/{room_id}/events`Preview](https://everruns.com/docs/api/operations/list_room_events/)[GET**List a room's shared files**`/v1/rooms/{room_id}/files`Preview](https://everruns.com/docs/api/operations/list_room_files/)[PUT**Write a room file**`/v1/rooms/{room_id}/files`Preview](https://everruns.com/docs/api/operations/write_room_file/)[DELETE**Delete a room file**`/v1/rooms/{room_id}/files`Preview](https://everruns.com/docs/api/operations/delete_room_file/)[GET**Read a room file**`/v1/rooms/{room_id}/files/content`Preview](https://everruns.com/docs/api/operations/read_room_file/)[POST**Edit part of a room file**`/v1/rooms/{room_id}/files/edit`Preview](https://everruns.com/docs/api/operations/edit_room_file/)[GET**Read a room file's history**`/v1/rooms/{room_id}/files/history`Preview](https://everruns.com/docs/api/operations/list_room_file_history/)[POST**Move or rename a room file**`/v1/rooms/{room_id}/files/move`Preview](https://everruns.com/docs/api/operations/move_room_file/)[POST**Restore an earlier version of a room file**`/v1/rooms/{room_id}/files/restore`Preview](https://everruns.com/docs/api/operations/restore_room_file/)[GET**List a room's members**`/v1/rooms/{room_id}/members`Preview](https://everruns.com/docs/api/operations/list_room_members/)[POST**Add a member to a room**`/v1/rooms/{room_id}/members`Preview](https://everruns.com/docs/api/operations/add_room_member/)[DELETE**Remove a member from a room**`/v1/rooms/{room_id}/members/{member_id}`Preview](https://everruns.com/docs/api/operations/remove_room_member/)[PATCH**Change a room member's settings**`/v1/rooms/{room_id}/members/{member_id}`Preview](https://everruns.com/docs/api/operations/update_room_member/)[GET**Read a room's top-level messages, oldest first**`/v1/rooms/{room_id}/messages`Preview](https://everruns.com/docs/api/operations/list_room_messages/)[POST**Post a message in a room, at the top level or as a reply**`/v1/rooms/{room_id}/messages`Preview](https://everruns.com/docs/api/operations/post_room_message/)[GET**Get one message**`/v1/rooms/{room_id}/messages/{message_id}`Preview](https://everruns.com/docs/api/operations/get_room_message/)[DELETE**Delete a message**`/v1/rooms/{room_id}/messages/{message_id}`Preview](https://everruns.com/docs/api/operations/delete_room_message/)[PATCH**Change a message's text**`/v1/rooms/{room_id}/messages/{message_id}`Preview](https://everruns.com/docs/api/operations/edit_room_message/)[POST**Pin a message to the room, or unpin it with pinned=false**`/v1/rooms/{room_id}/messages/{message_id}/pin`Preview](https://everruns.com/docs/api/operations/pin_room_message/)[POST**Add a reaction to a message, or remove it with add=false**`/v1/rooms/{room_id}/messages/{message_id}/reactions`Preview](https://everruns.com/docs/api/operations/react_to_room_message/)[GET**Who has read a message, and who has not**`/v1/rooms/{room_id}/messages/{message_id}/readers`Preview](https://everruns.com/docs/api/operations/list_room_message_readers/)[GET**Read the replies in a message's thread, oldest first**`/v1/rooms/{room_id}/messages/{message_id}/replies`Preview](https://everruns.com/docs/api/operations/list_room_replies/)[GET**List a room's pinned messages, most recently pinned first**`/v1/rooms/{room_id}/pins`Preview](https://everruns.com/docs/api/operations/list_room_pins/)[POST**Mark a room's top level, or a thread, read up to a message**`/v1/rooms/{room_id}/read`Preview](https://everruns.com/docs/api/operations/mark_room_read/)[GET**Find messages in a room by text, newest first**`/v1/rooms/{room_id}/search`Preview](https://everruns.com/docs/api/operations/search_room_messages/)[POST**Read and mark a room's unread messages**`/v1/rooms/{room_id}/unread`Preview](https://everruns.com/docs/api/operations/read_room_unread/)

No matching endpoints.

## Matching endpoints

## Support & compatibility

* Stable

  Documented compatibility. Breaking changes follow an announced deprecation period.

* Preview

  Public early access. Breaking changes may occur; review the changelog before upgrading.

* Experimental

  Evaluation only. No compatibility guarantee; the endpoint lists its availability requirements.

* Internal

  Platform operation and diagnostics. No external compatibility commitment.

* Deprecated

  Use the linked replacement or migration guide. Removal dates appear only when announced.

Current public APIs are Preview unless marked Experimental. Support labels describe compatibility, not access permissions or a service-level agreement.