Refresh an actor session

POST/v1/runtime/sessions/{session}/refresh

POST

/v1/runtime/sessions/{session}/refresh

const url = 'https://api.wabe.sh/v1/runtime/sessions/779742ad-cd09-4e1c-9170-f20968b344d4/refresh';
const options = {
  method: 'POST',
  headers: {'Idempotency-Key': 'demo', Authorization: 'Bearer <token>'}
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request POST \
  --url https://api.wabe.sh/v1/runtime/sessions/779742ad-cd09-4e1c-9170-f20968b344d4/refresh \
  --header 'Authorization: Bearer <token>' \
  --header 'Idempotency-Key: demo'

Authorizations

runtimeRefresh

Parameters

Path Parameters

session

required

string format: uuid

Example

779742ad-cd09-4e1c-9170-f20968b344d4

Session ID from the actor runtime.

Header Parameters

Idempotency-Key

required

string

/^[A-Za-z0-9_-]{1,128}$/

Example

demo

Reuse the key when retrying the same refresh.

Responses

200

Rotated runtime credentials.

application/json

object

sessionId

required

string format: uuid

Example

779742ad-cd09-4e1c-9170-f20968b344d4

accessToken

required

string

Example

YOUR_RUNTIME_TOKEN

accessExpiresAt

required

Unix timestamp in seconds.

integer format: int64

refreshToken

required

string

Example

YOUR_RUNTIME_TOKEN

refreshUrl

required

string format: uri

Example

https://api.wabe.sh/v1/runtime/sessions/779742ad-cd09-4e1c-9170-f20968b344d4/refresh

sessionExpiresAt

required

Unix timestamp in seconds.

integer format: int64

400

Invalid or missing Idempotency-Key.

application/json

object

error

required

object

code

required

string

message

required

string

401

Invalid or expired refresh token.

application/json

object

error

required

object

code

required

string

message

required

string

403

Instance generation or disk grant changed.

application/json

object

error

required

object

code

required

string

message

required

string

409

Session or refresh conflict.

application/json

object

error

required

object

code

required

string

message

required

string

429

Refresh rate limit exceeded.

application/json

object

error

required

object

code

required

string

message

required

string

503

Actor API temporarily unavailable.

application/json

object

error

required

object

code

required

string

message

required

string