Get skill candidate save and binding status¶
Read whether a reviewed candidate was saved and whether the skill is present in its eligible same-Workspace target agent. A returned skill ID does not mean it was saved.
GET https://api.moi.matrixorigin.cn/v5/workspaces/{workspace_id}/agent-runtime-tasks/{task_id}/skills/confirmation
Before you call this API¶
Start with a trusted structured skill candidate whose instructions and files have been reviewed. Use its original task_id/call_id/source_digest. The target Workspace, current principal, and original run must match. Do not substitute conversational text, manually constructed display data, or a candidate from another task. See Candidate identity for source and permission details.
Request parameters¶
curl --get "https://api.moi.matrixorigin.cn/v5/workspaces/$WORKSPACE_ID/agent-runtime-tasks/$TASK_ID/skills/confirmation" \
-H "X-API-Key: $AI_STUDIO_API_KEY" \
-H "X-Workspace-ID: $WORKSPACE_ID" \
--data-urlencode "call_id=$CALL_ID" --data-urlencode "source_digest=$SOURCE_DIGEST"
Parameter |
Type |
Required |
Description |
|---|---|---|---|
|
string |
Yes |
Target Workspace, matching X-Workspace-ID. |
|
string |
Yes |
Original runtime task ID that produced the candidate; not an automation task definition or skill ID. |
|
string |
Yes |
Target Workspace in the current environment. |
|
string |
Yes |
Personal access token used by this example; must also pass current Workspace access and candidate ownership checks. |
|
string |
Yes |
Original Skill Creator tool call identifier, supplied as a query parameter. |
|
string |
Yes |
Complete digest returned by the server candidate; use unchanged as a query parameter. |
Result¶
{
"code": 0,
"data": {
"skill_id": "skill-example",
"workspace_id": "ws-example",
"agent_id": "agent-example",
"saved": false,
"bound": false
}
}
Field |
Type |
Description |
|---|---|---|
|
integer |
0 on success. |
|
string |
Skill identifier for this candidate. GET also returns a reserved ID before saving. |
|
string |
Workspace where the skill is saved. |
|
string |
Target agent owning the original candidate, not the operator. |
|
boolean |
Whether a saved skill matching this candidate’s content and creator was found. |
|
boolean |
Whether this skill’s binding was found in the currently eligible same-Workspace target. Not a global binding query. |
Interpret the result¶
When saved=false, do not read or use a skill merely because skill_id is present. saved=true and bound=false means it was saved but no binding was found within this query’s scope. Cross-Workspace or system-source candidates cannot bind to the current target; GET does not establish that other agents outside this scope have no bindings. GET does not import skills or repair bindings.
See Saving, binding, and recovery, Actual errors and environments, and AI Studio.