{"command":{"effect":"write","timeoutSeconds":30,"inputSchema":{"type":"object","description":"Partial update of session-scoped settings (not the agent manifest / config). The body must include at least one recognized patchable property; an empty object {} is 400. Only properties listed on PatchSessionRequest are accepted — any other top-level JSON key is rejected with 400. Omitted properties are left unchanged. Today the only patchable field is resume_on_topoff; more session settings may be added over time. Terminal sessions (DESTROYED, FAILED) cannot be patched.","properties":{"path":{"type":"object","properties":{"session_id":{"type":"string","examples":["a1b2c3d4-e5f6-7890-abcd-ef1234567890"],"description":"The session UUID."}},"required":["session_id"],"additionalProperties":false},"body":{"$ref":"#/definitions/patch_session_request"}},"required":["path","body"],"additionalProperties":false,"definitions":{"patch_session_request":{"type":"object","additionalProperties":false,"properties":{"resume_on_topoff":{"type":"boolean","description":"When present, sets whether this session opts in to automatic resumption when the team's prepayment balance is restored after a low-balance pause. Session-scoped consent, not config-scoped. Omitted properties are not modified.","examples":[false]}},"description":"PATCH body for /v2/agents/sessions/{session_id}: an allowlisted subset of session-scoped settings (never environment-spec / config mutation). At least one property below must be present; {} is 400. Unknown top-level keys are rejected with 400. New patchable fields will be added here as optional properties over time."}}},"name":"PatchSession updates session-scoped settings on an existing session.","id":"digitalocean.harness_update_session","example":{"path":{"session_id":"a1b2c3d4-e5f6-7890-abcd-ef1234567890"},"body":{}},"maxRequests":1,"summary":false}}