Sessions
Get a session
Return the current status and metadata for a single session.
GET
/projects/{projectId}/sessions/{sessionId}HTTP client
Set up your HTTP client with the auth header before calling the API. Match the authentication type shown above.
const BASE_URL = 'https://api.mudbase.dev/api/sandboxes';
const HEADERS = {
'x-api-key': 'sk_YOUR_API_KEY',
'Content-Type': 'application/json',
};const BASE_URL = 'https://api.mudbase.dev/api/sandboxes';
const HEADERS = {
'x-api-key': 'sk_YOUR_API_KEY',
'Content-Type': 'application/json',
};Example request
Call this endpoint using the client from SDK setup. Use View HTTP for a raw cURL example.
const res = await fetch('https://api.mudbase.dev/api/sandboxes/projects/YOUR_PROJECT_ID/sessions/YOUR_SESSION_ID', {
method: 'GET',
headers: HEADERS,
});
const data = await res.json();const res = await fetch('https://api.mudbase.dev/api/sandboxes/projects/YOUR_PROJECT_ID/sessions/YOUR_SESSION_ID', {
method: 'GET',
headers: HEADERS,
});
const data = await res.json();Playground
liveTest this endpoint with your own credentials. Your requests will be sent to the live API.
Get your API key from the console
No Request Yet
Send a request to see the full inspector
Authentication
Requires API Key
Note
Include your API key in the
X-API-Key: YOUR_KEY header (server-to-server, SDKs). View authentication guide →Path Parameters
| Name | Type | Required | Description |
|---|---|---|---|
projectId | string | Yes | - |
sessionId | string | Yes | - |
Responses
200Session retrieved.
json
{
"sessionId": "sess_7LedsBSeQ3VvJ4AlVf",
"language": "en-US",
"languageVersion": "en-US",
"status": "running",
"timeoutAt": "2026-09-12T00:13:53.594Z",
"publicUrl": "https://peaceful-punctuation.net",
"alwaysOn": false,
"cellName": "Maggie O'Keefe"
}{
"sessionId": "sess_7LedsBSeQ3VvJ4AlVf",
"language": "en-US",
"languageVersion": "en-US",
"status": "running",
"timeoutAt": "2026-09-12T00:13:53.594Z",
"publicUrl": "https://peaceful-punctuation.net",
"alwaysOn": false,
"cellName": "Maggie O'Keefe"
}404Session not found.
Errors
| Code | Meaning |
|---|---|
404 | Session not found. |