Create filing session

Creates a new filing session for a filer. This operation 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.

Request

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.

Errors

This operation has no application errors.

Example

Request

curl -X POST https://api.rhetoric.law/create-filing-session \
  --header "Authorization: Bearer $API_KEY" \
  --header "Content-Type: application/json" \
  --data '{ "filer_id": "fil_01j9x1q7ssdtfpb5qmk4qzk8y0" }'

Response

{
  "result": "ok",
  "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

Request

Response

Errors

Example

​Request

​Response

​Errors

​Example

Request

Response

Errors

Example