curl -X POST "https://app.runtm.com/api/cloud/sessions/ses_abc123/visibility" \
-H "Authorization: Bearer runtm_xxx" \
-H "Content-Type: application/json" \
-d '{"visibility": "team"}'
import requests
response = requests.post(
"https://app.runtm.com/api/cloud/sessions/ses_abc123/visibility",
headers={
"Authorization": "Bearer runtm_xxx",
"Content-Type": "application/json",
},
json={"visibility": "team"},
)
print(response.json()["visibility"])
const response = await fetch(
"https://app.runtm.com/api/cloud/sessions/ses_abc123/visibility",
{
method: "POST",
headers: {
"Authorization": "Bearer runtm_xxx",
"Content-Type": "application/json",
},
body: JSON.stringify({ visibility: "team" }),
}
);
const session = await response.json();
console.log(session.visibility);
{
"id": "ses_abc123",
"name": "API refactor",
"visibility": "team",
"updated_at": "2026-05-09T21:20:00Z"
}
Sessions
Update Visibility
Change a session’s visibility between private and team
POST
/
api
/
sessions
/
{session_id}
/
visibility
curl -X POST "https://app.runtm.com/api/cloud/sessions/ses_abc123/visibility" \
-H "Authorization: Bearer runtm_xxx" \
-H "Content-Type: application/json" \
-d '{"visibility": "team"}'
import requests
response = requests.post(
"https://app.runtm.com/api/cloud/sessions/ses_abc123/visibility",
headers={
"Authorization": "Bearer runtm_xxx",
"Content-Type": "application/json",
},
json={"visibility": "team"},
)
print(response.json()["visibility"])
const response = await fetch(
"https://app.runtm.com/api/cloud/sessions/ses_abc123/visibility",
{
method: "POST",
headers: {
"Authorization": "Bearer runtm_xxx",
"Content-Type": "application/json",
},
body: JSON.stringify({ visibility: "team" }),
}
);
const session = await response.json();
console.log(session.visibility);
{
"id": "ses_abc123",
"name": "API refactor",
"visibility": "team",
"updated_at": "2026-05-09T21:20:00Z"
}
Updates the visibility of a session.
private sessions are only visible to the owner; team sessions are visible to all organization members.
Required scope: sessions:write
Path Parameters
string
required
The session ID (e.g.
ses_abc123).Headers
string
required
Bearer token. Example:
Bearer runtm_xxxstring
Scope to an organization.
Body
string
required
New visibility:
private or team.Response
Returns the updated session object.string
Session ID.
string
Updated visibility setting.
curl -X POST "https://app.runtm.com/api/cloud/sessions/ses_abc123/visibility" \
-H "Authorization: Bearer runtm_xxx" \
-H "Content-Type: application/json" \
-d '{"visibility": "team"}'
import requests
response = requests.post(
"https://app.runtm.com/api/cloud/sessions/ses_abc123/visibility",
headers={
"Authorization": "Bearer runtm_xxx",
"Content-Type": "application/json",
},
json={"visibility": "team"},
)
print(response.json()["visibility"])
const response = await fetch(
"https://app.runtm.com/api/cloud/sessions/ses_abc123/visibility",
{
method: "POST",
headers: {
"Authorization": "Bearer runtm_xxx",
"Content-Type": "application/json",
},
body: JSON.stringify({ visibility: "team" }),
}
);
const session = await response.json();
console.log(session.visibility);
{
"id": "ses_abc123",
"name": "API refactor",
"visibility": "team",
"updated_at": "2026-05-09T21:20:00Z"
}