Update Session Resource

Update Session Resource through the OMA API.

POST /v1/sessions/{session_id}/resources/{resource_id}

Update Session Resource

cURL

curl --request POST \
  --url http://localhost:38080/v1/sessions/{session_id}/resources/{resource_id} \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <api-key>' \
  --data '
{
  "authorization_token": "ghp_exampletoken"
}
'

200

{
  "type": "github_repository",
  "id": "sesrsc_011CZkZCKr6eXyl0gWMOdQiu",
  "url": "https://github.com/example-org/example-repo",
  "mount_path": "/workspace/example-repo",
  "checkout": {
    "type": "branch",
    "name": "main"
  },
  "created_at": "2026-03-15T10:00:00Z",
  "updated_at": "2026-03-15T10:00:00Z"
}

Every request requires ?beta=true.

Authorizations

omaApiKeyomaBearer

X-Api-Key · string · header · default: sk-ant-local-default · required

OMA workspace API key.

Headers

anthropic-version · string

anthropic-beta · string

Path Parameters

session_id · string · required

Path parameter session_id

resource_id · string · required

Path parameter resource_id

Query Parameters

beta · enum<boolean> · required

Selects the beta API contract for this endpoint. Must be true.

Available options: true

Body

application/json

Request parameters for updating a session resource.

authorization_token · string · required

New authorization token for the resource. Currently only github_repository resources support token rotation.

Required string length: 1 - 4096

Example:

"ghp_exampletoken"

Response

200

application/json

Successful response (OK)

Option 1

Option 2

Option 3

The updated session resource.

type · enum<string> · required

Available options: github_repository

Example:

"github_repository"

id · string · required

Example:

"sesrsc_011CZkZCKr6eXyl0gWMOdQiu"

url · string · required

Example:

"https://github.com/example-org/example-repo"

mount_path · string · required

Example:

"/workspace/example-repo"

created_at · string<date-time> · required

A timestamp in RFC 3339 format

Example:

"2026-03-15T10:00:00Z"

updated_at · string<date-time> · required

A timestamp in RFC 3339 format

Example:

"2026-03-15T10:00:00Z"

checkout · object

Option 1

Option 2

Show child attributes

Example:

{ "type": "branch", "name": "main" }