PAparley
Sessions

Rename a session

Rename a session. Parley stops writing titles for a session once someone names it.

patch/sessions/{id}

Request

  • Base URL
    https://api.parley.so/v1
  • URL
    https://api.parley.so/v1/sessions/{id}
  • Auth
    HTTP bearer

Path parameters

idstring required

The session ID.

Request body

titlestring required

A new title, up to 100 characters.

Response

OK

idstring required

The session ID.

titlestring nullable required

The session's title, written by Parley after the first reply unless someone named it, or null until then.

status'working' | 'idle' required

working: Parley's assistant is working, a message is waiting for it, or it is waiting on subagents it started in the background. idle: the assistant has stopped and is waiting for the next message.

origin'web' | 'word' | 'outlook' | 'automation' | 'api' required

Where the session was started: web (Parley's web app, or an email to Parley's assistant), word or outlook (the add-in), automation (an automation run), or api (the REST API, MCP, or the CLI).

urlstring uri required

Where to open the session in Parley.

createdAtstring date-time required

When the session was started.

updatedAtstring date-time required

When the session last changed, such as by a new message.

Changes

No recorded changes to this operation across all 2 revisions of this API.