user_sessions

Import Claude Session

Import messages from a Claude CLI session into a new Omnara session.

This creates:

  1. A new user_session linked to the workspace's main worktree
  2. A new agent_session for the imported messages
  3. All messages from the Claude CLI session

The agent_session_id can then be used as the resume_session_id when starting the SDK to resume from the imported session.

post/api/v1/user-sessions/import-claude-session

Request

  • Base URL: https://docs.omnara.com (the document declares no server; this is the origin it was published from)
  • URL: https://docs.omnara.com/api/v1/user-sessions/import-claude-session
  • Auth: HTTP bearer

Request body

workspace_idstring required

Workspace ID to import the session into

worktree_namestring nullable

Optional worktree name (null for main workspace)

claude_session_idstring required

Original Claude CLI session ID (used as SDK resume ID)

session_namestring nullable

Optional name for the imported session

Response

Successful Response

successboolean required

Whether the import was successful

user_session_idstring nullable

ID of the created user session

agent_session_idstring nullable

ID of the created agent session

message_countinteger

Number of messages successfully imported

errorstring nullable

Error message if the import failed

Changes

No recorded changes to this operation across all 1 revision of this API.