# Stop a session

Stop a running Meeting Buddy bot session gracefully.

Stop a running Meeting Buddy session. The bot leaves the meeting gracefully, all pending transcriptions are saved, recording metadata is finalized, and the session status is updated to `completed`.

Both the `DELETE` and `POST /stop` endpoints perform the same operation. Use whichever is more convenient for your client.

This operation is idempotent -- calling it multiple times on the same session will not cause errors. Already-stopped sessions return the current status without error.

#### Path Parameters

**`session_id`** string required

The unique identifier of the session to stop. Must start with `mbsess_` prefix.

## Returns

Returns the updated [Session object](/docs/api-reference/meeting-buddy/start-session#session-object) with status set to `completed`, including final recording statistics such as `leave_timestamp`, `total_duration_seconds`, `segment_count`, and file counts.

Request

```bash cURL
curl -s -X DELETE https://api.aitronos.com/v1/meeting-buddy/sessions/mbsess_abc123def456 \
  -H "Authorization: Bearer $ACCESS_TOKEN" | python3 -m json.tool
```


```python Python SDK
from aitronos import Aitronos

client = Aitronos(api_key="your-api-key")

session = client.meeting_buddy.stop_session(
    session_id="mbsess_abc123def456",
)

print(f"Status: {session.status}")
print(f"Duration: {session.total_duration_seconds}s")
print(f"Segments: {session.segment_count}")
```


```python Python
import os
import requests

access_token = os.environ["ACCESS_TOKEN"]
session_id = "mbsess_abc123def456"

url = f"https://api.aitronos.com/v1/meeting-buddy/sessions/{session_id}"
headers = {"Authorization": f"Bearer {access_token}"}

response = requests.delete(url, headers=headers)
session = response.json()
print(f"Status: {session['status']}")
print(f"Duration: {session['total_duration_seconds']}s")
```


```javascript JavaScript
const accessToken = process.env.ACCESS_TOKEN;
const sessionId = 'mbsess_abc123def456';

const response = await fetch(
  `https://api.aitronos.com/v1/meeting-buddy/sessions/${sessionId}`,
  {
    method: 'DELETE',
    headers: {
      'Authorization': `Bearer ${accessToken}`,
    },
  }
);

const session = await response.json();
console.log('Status:', session.status);
console.log('Duration:', session.total_duration_seconds, 's');
```

Response

```json 200 OK
{
  "session_id": "mbsess_abc123def456",
  "organization_id": "org_xyz789",
  "user_id": "usr_user123",
  "meeting_link": "https://teams.microsoft.com/l/meetup-join/abc123",
  "platform": "teams",
  "bot_name": "Meeting Buddy",
  "status": "completed",
  "transcription_enabled": true,
  "transcription_language": "en",
  "debug_mode": false,
  "created_at": "2025-12-11T10:00:00Z",
  "updated_at": "2025-12-11T10:30:00Z",
  "join_timestamp": "2025-12-11T10:01:00Z",
  "leave_timestamp": "2025-12-11T10:30:00Z",
  "total_duration_seconds": 1740.5,
  "segment_count": 87,
  "audio_file_count": 87,
  "video_file_count": 0,
  "total_size_bytes": 304857600,
  "output_directory": "recordings/org_xyz789/mbsess_abc123def456",
  "error_message": null,
  "error_code": null,
  "metadata": {},
  "current_participants": {},
  "participant_history": []
}
```


```json 403 Forbidden
{
  "success": false,
  "error": {
    "code": "SESSION_ACCESS_DENIED",
    "message": "You don't have access to this session",
    "type": "client_error",
    "status": 403,
    "details": {
      "session_id": "mbsess_abc123def456"
    },
    "trace_id": "abc-123-def",
    "timestamp": "2025-12-11T10:00:00Z"
  }
}
```


```json 404 Not Found
{
  "success": false,
  "error": {
    "code": "SESSION_NOT_FOUND",
    "message": "Session not found",
    "type": "client_error",
    "status": 404,
    "details": {
      "session_id": "mbsess_abc123def456"
    },
    "trace_id": "abc-123-def",
    "timestamp": "2025-12-11T10:00:00Z"
  }
}
```


```json 422 Validation Error
{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid session_id format",
    "type": "client_error",
    "status": 422,
    "details": {
      "session_id": "invalid_id"
    },
    "trace_id": "abc-123-def",
    "timestamp": "2025-12-11T10:00:00Z"
  }
}
```


```json 500 Internal Server Error
{
  "success": false,
  "error": {
    "code": "SESSION_STOP_FAILED",
    "message": "Failed to stop bot session",
    "type": "server_error",
    "status": 500,
    "details": {},
    "trace_id": "abc-123-def",
    "timestamp": "2025-12-11T10:00:00Z"
  }
}
```

## Related Resources

- [Start Session](/docs/api-reference/meeting-buddy/start-session)
- [List Sessions](/docs/api-reference/meeting-buddy/list-sessions)
- [Get Session Details](/docs/api-reference/meeting-buddy/get-session)
- [Get Transcripts](/docs/api-reference/meeting-buddy/get-transcripts)
- [Export Transcript](/docs/api-reference/meeting-buddy/export-transcript)
- [Delete Session](/docs/api-reference/meeting-buddy/delete-session)
- [Stream Session Status](/docs/api-reference/meeting-buddy/session-status-stream)
- [Stream Transcripts](/docs/api-reference/meeting-buddy/transcript-stream)
- [Stream Logs](/docs/api-reference/meeting-buddy/log-stream)
- [Analytics Summary](/docs/api-reference/meeting-buddy/analytics-summary)