---
title: "Remove app from session"
method: DELETE
path: "/api/v1/socket-sessions/{session_id}/apps/{app_id}"
---

# Remove app from session

`DELETE /api/v1/socket-sessions/{session_id}/apps/{app_id}`

## Request

- Base URL: `https://app.base44.com`
- URL: `https://app.base44.com/api/v1/socket-sessions/{session_id}/apps/{app_id}`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

<Info>This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.</Info>

Stops a session watching an app. A connected browser leaves the app's room right away and receives `room.access_revoked`. Removing an app the session doesn't watch changes nothing.

Available only to white-label workspaces on the Builder plan or higher, with live AI chat updates turned on. Ask your onboarding contact to turn them on for your workspace.

Session calls are limited to 600 requests a minute per workspace. Some workspaces have a different limit. Every request that counts against the limit gets `X-RateLimit-Limit`, `X-RateLimit-Remaining` and `X-RateLimit-Reset` (Unix time in seconds) headers, and a `429` also gets `Retry-After` in seconds.

## Path parameters

- `session_id` string, required: ID of the session, from `session_id` in [Create socket session](/api-reference/create-socket-session).
- `app_id` string, required: ID of the app.

## Response `200`

The session no longer watches the app. `app_ids` lists the apps it still may watch.

- SocketSessionAppsResponse
  - `session_id` string, required: ID of the session.
  - `app_ids` string[], required: IDs of the apps the session may now watch.

## Other responses

- `401`: The request has no Bearer token, or the key or personal access token isn't valid (`unauthenticated`).
- `403`: The key doesn't have the **Watch app builder updates** permission (`scope_required`), or the workspace turned personal access tokens off (`personal_access_token_policy_violation`).
- `404`: The session ended, expired, or was opened by another key or token (`session_not_found`).
- `422`: `session_id` or `app_id` isn't a valid ID (`invalid_request`).
- `429`: Rate limit reached (`rate_limited`). Retry later.

## Changes

> 58 revisions in range; 1 not diffed.

- **2026-10-19** `bf3bf64eaea3`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/adexad/apis/base44-app-management-api/changes/api/v1/socket-sessions/:session_id/apps/:app_id/delete.md)

---

[API](https://skmtc.dev/adexad/apis/base44-app-management-api.md) · [All operations](https://skmtc.dev/adexad/apis/base44-app-management-api/llms.txt) · [OpenAPI document](https://skmtc.dev/adexad/apis/base44-app-management-api/revisions/fa29e915c226?raw)