# Get skill candidate save and binding status

```{raw} html
<div class="mo-api-page-show-toc" aria-hidden="true"></div>
```

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.

```text
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](candidate-identity.md) for source and permission details.

## Request parameters

:::::::{div} mo-api-tabs
::::::{tab-set}
:::::{tab-item} Request example

```bash
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"
```

:::::
:::::{tab-item} Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `workspace_id` | string | Yes | Target Workspace, matching X-Workspace-ID. |
| `task_id` | string | Yes | Original runtime task ID that produced the candidate; not an automation task definition or skill ID. |
| `X-Workspace-ID` | string | Yes | Target Workspace in the current environment. |
| `X-API-Key` | string | Yes | Personal access token used by this example; must also pass current Workspace access and candidate ownership checks. |
| `call_id` | string | Yes | Original Skill Creator tool call identifier, supplied as a query parameter. |
| `source_digest` | string | Yes | Complete digest returned by the server candidate; use unchanged as a query parameter. |

:::::
::::::
:::::::

## Result

:::::::{div} mo-api-tabs mo-api-response-tabs
::::::{tab-set}
:::::{tab-item} Response example

```json
{
  "code": 0,
  "data": {
    "skill_id": "skill-example",
    "workspace_id": "ws-example",
    "agent_id": "agent-example",
    "saved": false,
    "bound": false
  }
}
```

:::::
:::::{tab-item} Fields

| Field | Type | Description |
| --- | --- | --- |
| `code` | integer | 0 on success. |
| `data.skill_id` | string | Skill identifier for this candidate. GET also returns a reserved ID before saving. |
| `data.workspace_id` | string | Workspace where the skill is saved. |
| `data.agent_id` | string | Target agent owning the original candidate, not the operator. |
| `data.saved` | boolean | Whether a saved skill matching this candidate's content and creator was found. |
| `data.bound` | 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](save-bind-recovery.md), [Actual errors and environments](errors-environments.md), and [AI Studio](../../../../../../developer/api/ai-studio/index.md).
