Update embedding routing configuration (root endpoint)

Write the complete embedding routing configuration for the current workspace.

PUT https://api.moi.matrixorigin.cn/v5/embedding/router

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.

Configure identity, Workspace, and object permissions in the same environment.

Request

curl --request PUT \
  "$BASE_URL/embedding/router" \
  --header "X-API-Key: $MOI_KEY" \
  --header "X-Workspace-ID: $WORKSPACE_ID" \
  --header "Content-Type: application/json" \
  --data-raw '{"strategy":"ROUND_ROBIN","health_check_interval":30,"max_retries":1,"session_affinity":false}'

Parameter

Location

Type

Required

Description

X-Workspace-ID

Header

string

Yes

Workspace ID in the same environment.

strategy

Body

string

No

Three defined strings. Omission or an invalid value uses ROUND_ROBIN.

health_check_interval

Body

integer

No

Positive seconds. Omitted/nonpositive values become 30.

max_retries

Body

integer

No

LLM: nonpositive values use 0. Embedding: nonpositive values use 2.

session_affinity

Body

boolean

No

Omission/null means false and overwrites the previous configuration.

Requires Workspace model_router.update. Writes complete configuration using request values and defaults, not a patch preserving omitted fields. Save old values before writing and read back afterward. Successful configuration does not establish verified routing, session affinity, or retry behavior.

Successful response

{
  "code": "OK",
  "msg": "OK",
  "data": {
    "strategy": "ROUND_ROBIN",
    "health_check_interval": 30,
    "max_retries": 1,
    "session_affinity": false
  }
}

HTTP 200。

Field

Type

Description

code

string

OK on success.

msg

string

OK on success.

data

object

Actual objects for this protocol.

Error response

Errors and result confirmation distinguishes the two protocols. Parse omitted fields, SDK zero values, and empty HTTP responses separately. Confirm writes using the corresponding read operation.

Last updated on