---
orphan: true
---

# Query the agent workflow binding details

Query the binding configuration of a workflow node and an agent task template.

```text
GET https://moi.matrixorigin.cn/newmoi/workspaces/{workspace_id}/agent-workflow-bindings/{binding_id}
```

## Before you call

The example below uses:

- `$AI_STUDIO_API_KEY`: Actual personal access token.
- `$WORKSPACE_ID`: Target workspace ID.
- `$BINDING_ID`: Binding ID obtained from binding list.

## Request example

```bash
curl "https://moi.matrixorigin.cn/newmoi/workspaces/$WORKSPACE_ID/agent-workflow-bindings/$BINDING_ID" -H "X-API-Key: $AI_STUDIO_API_KEY" -H "X-Workspace-ID: $WORKSPACE_ID"
```

## Path parameters

| Parameters | Type | Is it required | Description |
| --- | --- | --- | --- |
| `workspace_id` | string | Yes | The target workspace ID. |
| `binding_id` | string | Yes | The binding ID to query. |

## Successful response

Returns `200` and binding configuration on success.

```json
{"code": 0, "data": {"id": "binding_01", "workflow_id": "wf_01", "node_id": "node_01", "agent_task_template_id": "template_01", "input_mapping": {}}}
```

The response fields are as follows.

| Field | Type | Description |
| --- | --- | --- |
| `code` | integer | `0` on success. |
| `data.id` | string | Binding ID. |
| `data.workflow_id` | string | Workflow ID. |
| `data.node_id` | string | Node ID. |
| `data.agent_task_template_id` | string | Association template ID. |
| `data.input_mapping` | object | Mapping of workflow input to template input. |

## Error response

```json
{"code": 5, "message": "agent workflow binding not found"}
```

### Common HTTP errors

```{list-table}
:header-rows: 1

* - HTTP status code
  - error code
  - Common causes
  - Recommended actions
* - `404`
  - `5`
  - The binding does not exist.
  - Check binding ID and workspace.
```