Skip to main content
Version: v2.0

Set Session Stream Header

POST 
/sessions/streams/header

Rename a session.

name_source says where the name came from: manual (the default) is a person typing one, and automatic is a program proposing one — the agent's rename_session, or the browser's auto-title. An automatic edit is refused with 409 when it would change a name a person controls, unless the body names the exact name and revision it replaces.

It is a query parameter rather than a body field on purpose. The rename_session catalog entry fixes name_source=automatic inside its path and the model fills only the body, so an agent cannot claim a person chose its name.

author is the transitional spelling, hidden from the schema. A warm agent session holds the tool descriptors it opened with, so a sandbox that started under an earlier build of this change can still execute ?author=auto after the service has moved on. Reading it costs one branch and keeps that call on the guarded path; the alternative is a rename that silently claims a person made it. Delete this parameter once no such session can still be alive.

visibility is the visibility a header call that creates the session asks for. It is ignored on an existing session, and a private without an owner is dropped. A call with a visibility may carry no header field: it only creates the session (the /w pre-create of a new chat) and changes nothing on an existing one. Without a visibility, a body with no header field (an empty or wrapped body) is refused.

Request​

Responses​

Successful Response