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 |
|---|---|---|---|---|
|
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 |
|---|---|---|
|
integer |
0 on success. |
|
object |
Error response¶
Errors and recovery boundaries distinguishes Runner, Edge renewal, and compute observations. They do not share one numeric error table.