PIpipeshub-ai
Agents

Fork agent conversation from a message

Changed on

Copy this agent conversation into a new private chat owned by the caller, including every message up to and including messageId. The original conversation is left unchanged.

Only the owner of the conversation can fork it; anyone else gets 404.

post/agents/{agentKey}/conversations/{conversationId}/message/{messageId}/fork

Request

  • Base URL
    https://app.pipeshub.com/api/v1
  • URL
    https://app.pipeshub.com/api/v1/agents/{agentKey}/conversations/{conversationId}/message/{messageId}/fork
  • Auth
    • HTTP bearer
    • or OAuth 2
      Authorization code: /api/v1/oauth2/authorize
      Client credentials
      Token URL: /api/v1/oauth2/token scopes: agent:execute

Path parameters

agentKeystring required
conversationIdstring objectId required
messageIdstring objectId required

Inclusive last message to copy into the new chat

Response

Forked conversation created

idstring objectId required

New conversation identifier

titlestring required

Title of the forked conversation

projectIdstring objectId

Project the fork is linked to. Present only when the source conversation belonged to a project that the caller can still view; otherwise omitted.

messageCountinteger required

Number of messages copied into the new conversation

Changes

  • dbb5e203b445Revision changes
    • info

      added the media type application/json for the response with the status

    • info

      added the media type application/json for the response with the status

    • info

      added the media type application/json for the response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

  • a90ab79f26a1Revision changes
    • info

      endpoint added