Skip to main content
PATCH
/
api
/
sessions
/
{sessionId}
Update session
curl --request PATCH \
  --url https://api.recoupable.com/api/sessions/{sessionId} \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "title": "<string>",
  "status": "running",
  "linesAdded": 1,
  "linesRemoved": 1
}
'
{
  "session": {
    "id": "<string>",
    "userId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "title": "<string>",
    "status": "running",
    "isNewBranch": true,
    "globalSkillRefs": [
      {}
    ],
    "lifecycleVersion": 123,
    "createdAt": "2023-11-07T05:31:56Z",
    "updatedAt": "2023-11-07T05:31:56Z",
    "repoOwner": "<string>",
    "repoName": "<string>",
    "branch": "<string>",
    "cloneUrl": "<string>",
    "sandboxState": {},
    "lifecycleState": "provisioning",
    "lastActivityAt": "2023-11-07T05:31:56Z",
    "sandboxExpiresAt": "2023-11-07T05:31:56Z",
    "hibernateAfter": "2023-11-07T05:31:56Z",
    "lifecycleRunId": "<string>",
    "lifecycleError": "<string>",
    "linesAdded": 123,
    "linesRemoved": 123,
    "snapshotUrl": "<string>",
    "snapshotCreatedAt": "2023-11-07T05:31:56Z",
    "snapshotSizeBytes": 123,
    "cachedDiff": {},
    "cachedDiffUpdatedAt": "2023-11-07T05:31:56Z"
  }
}

Documentation Index

Fetch the complete documentation index at: https://developers.recoupable.com/llms.txt

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

Authorizations

​
x-api-key
string
header
required

Path Parameters

​
sessionId
string
required

The id of the session to update.

Body

application/json

All fields are optional. Omitted fields are left unchanged.

​
title
string

New display title for the session (rename).

​
status
enum<string>

Lifecycle status (matches the DB CHECK). running is active / unarchived; completed and failed are terminal; archived archives the row. Use running to unarchive from archived.

Available options:
running,
completed,
failed,
archived
​
linesAdded
integer

Updates the persisted lines_added column on the session (≥ 0).

Required range: x >= 0
​
linesRemoved
integer

Updates the persisted lines_removed column on the session (≥ 0).

Required range: x >= 0

Response

Session updated successfully.

​
session
object
required