Session

Create, resume, heartbeat, or close a session

Multiplexed endpoint. Set action to one of: create, resume, heartbeat, close. create returns a one-time sessionToken. All mutating follow-up actions require sessionId, owning agentAddress, and sessionToken in the JSON body or the X-FarmDash-Session-Token header. Pioneer+ required.

post/v1/agent/session

Request

  • Base URL: https://www.farmdash.one/api
  • URL: https://www.farmdash.one/api/v1/agent/session
  • Auth: HTTP bearer

Headers

X-ClawHub-Skillstring
Example:farmdash-signal-architect

ClawHub skill attribution. An installed FarmDash skill sends its canonical skill slug (e.g. farmdash-signal-architect) on every FarmDash API request so anonymous Scout usage can be attributed to the skill that drove it. Optional and analytics-only: absence never blocks a request, and malformed values are ignored. This is a skill identity, never a wallet address, API key, or user ID.

Request body

action'create' | 'resume' | 'heartbeat' | 'close' required
agentAddressstring

Required for create, resume, heartbeat, and close

sessionIdstring

Required for resume, heartbeat, close

sessionTokenstring

Required for resume, heartbeat, and close; returned only once by create

Response

Session action result

okboolean
sessionTokenstring

One-time session capability returned only when action is create

Changes

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