curl -X PATCH "https://app.runtm.com/api/cloud/sessions/550e8400-e29b-41d4-a716-446655440000/deploy/volumes" \
-H "Authorization: Bearer runtm_xxx" \
-H "Content-Type: application/json" \
-d '{
"volumes": [
{"name": "data", "mount_path": "/data", "size_gb": 1},
{"name": "uploads", "mount_path": "/app/uploads", "size_gb": 3}
]
}'
import requests
response = requests.patch(
"https://app.runtm.com/api/cloud/sessions/550e8400-e29b-41d4-a716-446655440000/deploy/volumes",
headers={
"Authorization": "Bearer runtm_xxx",
"Content-Type": "application/json",
},
json={
"volumes": [
{"name": "data", "mount_path": "/data", "size_gb": 1},
{"name": "uploads", "mount_path": "/app/uploads", "size_gb": 3},
]
},
)
data = response.json()
print(f"Updated {len(data['volumes'])} volumes")
const response = await fetch(
"https://app.runtm.com/api/cloud/sessions/550e8400-e29b-41d4-a716-446655440000/deploy/volumes",
{
method: "PATCH",
headers: {
"Authorization": "Bearer runtm_xxx",
"Content-Type": "application/json",
},
body: JSON.stringify({
volumes: [
{ name: "data", mount_path: "/data", size_gb: 1 },
{ name: "uploads", mount_path: "/app/uploads", size_gb: 3 },
],
}),
}
);
const data = await response.json();
console.log(`Updated ${data.volumes.length} volumes`);
{
"volumes": [
{
"name": "data",
"mount_path": "/data",
"size_gb": 1
},
{
"name": "uploads",
"mount_path": "/app/uploads",
"size_gb": 3
}
]
}
Deploy
Update Volumes
Update persistent volume configuration for a session
PATCH
/
api
/
sessions
/
{session_id}
/
deploy
/
volumes
curl -X PATCH "https://app.runtm.com/api/cloud/sessions/550e8400-e29b-41d4-a716-446655440000/deploy/volumes" \
-H "Authorization: Bearer runtm_xxx" \
-H "Content-Type: application/json" \
-d '{
"volumes": [
{"name": "data", "mount_path": "/data", "size_gb": 1},
{"name": "uploads", "mount_path": "/app/uploads", "size_gb": 3}
]
}'
import requests
response = requests.patch(
"https://app.runtm.com/api/cloud/sessions/550e8400-e29b-41d4-a716-446655440000/deploy/volumes",
headers={
"Authorization": "Bearer runtm_xxx",
"Content-Type": "application/json",
},
json={
"volumes": [
{"name": "data", "mount_path": "/data", "size_gb": 1},
{"name": "uploads", "mount_path": "/app/uploads", "size_gb": 3},
]
},
)
data = response.json()
print(f"Updated {len(data['volumes'])} volumes")
const response = await fetch(
"https://app.runtm.com/api/cloud/sessions/550e8400-e29b-41d4-a716-446655440000/deploy/volumes",
{
method: "PATCH",
headers: {
"Authorization": "Bearer runtm_xxx",
"Content-Type": "application/json",
},
body: JSON.stringify({
volumes: [
{ name: "data", mount_path: "/data", size_gb: 1 },
{ name: "uploads", mount_path: "/app/uploads", size_gb: 3 },
],
}),
}
);
const data = await response.json();
console.log(`Updated ${data.volumes.length} volumes`);
{
"volumes": [
{
"name": "data",
"mount_path": "/data",
"size_gb": 1
},
{
"name": "uploads",
"mount_path": "/app/uploads",
"size_gb": 3
}
]
}
Replaces the session’s persistent volume configuration. Volumes are stored in session metadata and merged into
runtm.yaml by name at deploy time. Volume names must be unique within the request.
Required scope: deployments:write
Path Parameters
string
required
The session ID (UUID).
Headers
string
required
Bearer token. Example:
Bearer runtm_xxxstring
Scope to an organization.
Body
array
required
List of volume specifications. Each volume must have a unique
name.string
required
Volume name (used as the identifier when merging into
runtm.yaml).string
required
Mount path inside the container (e.g.
/data).integer
required
Volume size in gigabytes.
Response
array
The updated list of volume specifications.
curl -X PATCH "https://app.runtm.com/api/cloud/sessions/550e8400-e29b-41d4-a716-446655440000/deploy/volumes" \
-H "Authorization: Bearer runtm_xxx" \
-H "Content-Type: application/json" \
-d '{
"volumes": [
{"name": "data", "mount_path": "/data", "size_gb": 1},
{"name": "uploads", "mount_path": "/app/uploads", "size_gb": 3}
]
}'
import requests
response = requests.patch(
"https://app.runtm.com/api/cloud/sessions/550e8400-e29b-41d4-a716-446655440000/deploy/volumes",
headers={
"Authorization": "Bearer runtm_xxx",
"Content-Type": "application/json",
},
json={
"volumes": [
{"name": "data", "mount_path": "/data", "size_gb": 1},
{"name": "uploads", "mount_path": "/app/uploads", "size_gb": 3},
]
},
)
data = response.json()
print(f"Updated {len(data['volumes'])} volumes")
const response = await fetch(
"https://app.runtm.com/api/cloud/sessions/550e8400-e29b-41d4-a716-446655440000/deploy/volumes",
{
method: "PATCH",
headers: {
"Authorization": "Bearer runtm_xxx",
"Content-Type": "application/json",
},
body: JSON.stringify({
volumes: [
{ name: "data", mount_path: "/data", size_gb: 1 },
{ name: "uploads", mount_path: "/app/uploads", size_gb: 3 },
],
}),
}
);
const data = await response.json();
console.log(`Updated ${data.volumes.length} volumes`);
{
"volumes": [
{
"name": "data",
"mount_path": "/data",
"size_gb": 1
},
{
"name": "uploads",
"mount_path": "/app/uploads",
"size_gb": 3
}
]
}