create-filing-session

Creates a new filing session for a filer. This command returns a session token that can be passed to an embedded Element in the browser. The Element uses the token to make subsequent calls to Rhetoric directly.

Flags

string

required

The ID of the filer operating the filing session.

Response

object

The created session.

Hide session

string

The session ID.

string

The time the session was created, in RFC 3339 format.

string

The ID of the filer operating the session.

string

The status of the session. One of active, submitted, or expired.

string

Bearer token used to authenticate session requests. The Element component embedded in the browser uses this to drive the session. This token is only returned once and cannot be recovered, so keep it somewhere safe.

Example

rhetoric create-filing-session --filer-id fil_01j9x1q7ssdtfpb5qmk4qzk8y0

{
  "session": {
    "id": "fsn_01j9x1r2ttbwgqc6rnm5r0m9z2",
    "created_at": "2026-08-13T21:00:00Z",
    "filer_id": "fil_01j9x1q7ssdtfpb5qmk4qzk8y0",
    "status": "active"
  },
  "session_token": "fst_9c1e2a8f4b6d0e7c3a5f1b9d2e4c6a8b"
}

Guides

API Reference

CLI Reference

create-filing-session

Flags

Response

Example

​Flags

​Response

​Example

Flags

Response

Example