Ara
Download

Search or run a command

Jump to a section or open an Ara link.

Protocol method · session

session.begin

Begin a session: returns the handle every other call takes, and the scopes granted.

  • Scope: none (no session needed)
  • Service: core
  • MCP: ara_session with "action": "begin"

Params

ParamRequiredDescription
clientyesWho is connecting: claude-code, codex, editor, ara-cli.
authorTransaction author: human or agent:<name>. Defaults to agent:<client>.
scopesScopes to request: read, edit:scene, edit:assets, edit:code, play, run, import, bake, build, generate:$, fs:outside-project, net. Defaults to everything the approval policy allows. The policy may grant fewer.
labelShort description of the work, shown in review.