Sessions

Expose a port

Expose an additional port on the session so a running service is reachable from the internet.

AuthAPI Key
GroupSessions
Rate limitSee Rate Limits
POST/projects/{projectId}/sessions/{sessionId}/expose

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/expose', {
  method: 'POST',
  headers: HEADERS,
  body: JSON.stringify({
      "port": 97096,
      "access": "token-gated"
    }),
});
const data = await res.json();
const res = await fetch('https://api.mudbase.dev/api/sandboxes/projects/YOUR_PROJECT_ID/sessions/YOUR_SESSION_ID/expose', {
  method: 'POST',
  headers: HEADERS,
  body: JSON.stringify({
      "port": 97096,
      "access": "token-gated"
    }),
});
const data = await res.json();

Playground

live

Test 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

NameTypeRequiredDescription
projectIdstringYes-
sessionIdstringYes-

Request Body

json
{
  "port": 97096,
  "access": "token-gated"
}
{
  "port": 97096,
  "access": "token-gated"
}

Responses

200Port exposed.
Edit this page on GitHub