Renew an Edge registration token

Holder protocol without a product identity wrapper. Rejects ephemeral eph executors. runner- prefix selects Runner binding; otherwise Sandbox binding is checked. Renewal atomically revokes old credentials and updates binding. Response uses numeric code 0.

POST https://api.moi.matrixorigin.cn/v5/edge-tokens/renew

Before you call this API

BASE_URL uses the product API prefix https://api.moi.matrixorigin.cn/v5. For a dedicated deployment, use its corresponding product API address.

Prepare identity and identifiers.

Request

curl --request POST \
  "$BASE_URL/edge-tokens/renew" \
  --header "Content-Type: application/json" \
  --data @- <<JSON
{"token": "${EDGE_TOKEN}"}
JSON

Parameter

Location

Type

Required

Description

token

Body

string

Yes

Current valid Edge registration token with matching JTI, not a product PAT, visitor session, or task RuntimeGrant.

Successful response

{
  "code": 0,
  "data": {
    "token": "example-fresh-edge-token",
    "expires_at": "2026-12-12T01:00:00Z"
  }
}

Field

Type

Description

code

integer

0 on success.

data

object

Response objects and omission rules.

Error response

Errors and recovery boundaries distinguishes Runner, Edge renewal, and compute observations. They do not share one numeric error table.

Last updated on