Sessions

Fork a session

Changed on

Requires run. Creates a new Session from this one's conversation up to its latest reply. The source Session is unchanged. 404 sidechat_source_not_found or sidechat_fork_point_not_found when there is nothing to fork from (no reply yet). Repeating a request with the same client_session_id returns the first fork.

<sub>Scope: run</sub>

post/v3/organizations/{orgId}/sessions/{sessionId}/fork

Request

  • Base URL
    https://api.reasonmachines.com
  • URL
    https://api.reasonmachines.com/v3/organizations/{orgId}/sessions/{sessionId}/fork
  • Auth
    HTTP bearer

Request body

messagestring

The fork's first message. Without one the fork opens on the conversation so far and waits for a message.

titlestring

Title shown for the new Session. Omitted, it is "Fork of" followed by the source Session's title, or "Fork of session" when it has none.

client_session_idstring uuid

A fresh UUID for the new Session; repeating it returns the first fork instead of making another.

Response

The fork's session_id.

oktrue required

Always true on success.

session_idstring nullable required

The new Session the fork created. Typed nullable with the admission receipt; a 200 carries an id.

Changes