Skip to main content
PATCH
/
ask
/
sessions
/
{id}
curl -X PATCH "https://api.bota.dev/v1/ask/sessions/as_abc123" \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "title": "Weekly commitments" }'

{
  "id": "as_abc123",
  "scope": { "type": "library", "recording_ids": [], "recording_title": null },
  "title": "Weekly commitments",
  "message_count": 4,
  "last_message_at": "2026-05-20T10:23:45Z",
  "last_model": "gemini-2.0-flash",
  "last_provider": "gemini",
  "created_at": "2026-05-20T10:20:00Z",
  "updated_at": "2026-05-20T10:25:10Z"
}
Update a session’s title.

​
Authentication

Requires an API key. The session is looked up within the key’s project; an unknown session returns 404. An end-user-scoped key can only update its own sessions. 
curl -X PATCH "https://api.bota.dev/v1/ask/sessions/as_abc123" \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "title": "Weekly commitments" }'

​
Path Parameters

​
id
string
required
Session identifier (as_*).

​
Request Body

​
title
string
required
New session title (1–200 characters).

​
Response

Returns the updated session object. 
{
  "id": "as_abc123",
  "scope": { "type": "library", "recording_ids": [], "recording_title": null },
  "title": "Weekly commitments",
  "message_count": 4,
  "last_message_at": "2026-05-20T10:23:45Z",
  "last_model": "gemini-2.0-flash",
  "last_provider": "gemini",
  "created_at": "2026-05-20T10:20:00Z",
  "updated_at": "2026-05-20T10:25:10Z"
}