Skip to main content
POST
/
api
/
local
/
synapse
/
session
Local storage sessions
curl --request POST \
  --url https://api.compose.market/api/local/synapse/session \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --header 'x-session-user-address: <x-session-user-address>' \
  --data '
{
  "agentWallet": "<string>",
  "deviceId": "<string>",
  "sessionKeyAddress": "<string>",
  "sessionKeyExpiresAt": 123,
  "depositAmount": "<string>",
  "fileSizeBytes": 123,
  "copies": 123
}
'

Documentation Index

Fetch the complete documentation index at: https://docs.compose.market/llms.txt

Use this file to discover all available pages before exploring further.

Storage routes are POST-only and require a valid active session Compose Key.

​
Routes

MethodPathDescription
POST/api/local/synapse/sessionEnsures a local Synapse storage session.
POST/api/local/filecoin-pin/sessionEnsures a local Filecoin Pin session.

​
Common body

​
agentWallet
string
required
Agent wallet address.
​
deviceId
string
required
Local device ID.
​
sessionKeyAddress
string
required
Session key wallet address.
​
sessionKeyExpiresAt
number
required
Requested expiry timestamp. The route caps it to the active session expiry.
​
depositAmount
string
Synapse deposit amount as a non-negative integer string.
​
fileSizeBytes
number
Required by /api/local/filecoin-pin/session.
​
copies
number
Optional Filecoin Pin copy count. Defaults to 2.

​
Headers

​
Authorization
string
required
Bearer compose-... for the active session key.
​
x-session-user-address
string
required
Wallet address that owns the active session.
​
x-chain-id
number
Chain ID. Defaults to the active chain when omitted.