Read task MCP App resources¶
Read app resources bound to a runtime task. URI identifies the resource; the backend resolves the actual service URL and credentials.
POST https://api.moi.matrixorigin.cn/v5/workspaces/{workspace_id}/agent-runtime-tasks/{task_id}/mcp-apps/resource
Before you call this API¶
Prepare a personal access token, Workspace ID, and a runtime task that returned an app description in the current environment. Use the original task’s tool ID, app resource URI, or tool name. The current identity still requires agent-use and corresponding connection/service privileges. See Task scope and results.
Request parameters¶
curl -X POST "https://api.moi.matrixorigin.cn/v5/workspaces/$WORKSPACE_ID/agent-runtime-tasks/$TASK_ID/mcp-apps/resource" \
-H "X-API-Key: $AI_STUDIO_API_KEY" \
-H "X-Workspace-ID: $WORKSPACE_ID" \
-H "Content-Type: application/json" \
--data '{"tool_id":"tool-example","uri":"ui://example/card.html"}'
Parameter |
Type |
Required |
Description |
|---|---|---|---|
|
string |
Yes |
Workspace ID in the current environment, matching X-Workspace-ID. |
|
string |
Yes |
Agent runtime task ID owning this app. |
|
string |
Yes |
Workspace owning the request. |
|
string |
Yes |
Personal access token in the current environment. |
|
string |
Yes |
Absolute resource URI already bound to the original task. Use unchanged, without credentials, at most 2048 bytes. |
|
string |
No |
Narrows URI lookup to one tool in the original task. |
Successful response¶
{
"code": 0,
"data": {
"uri": "ui://example/card.html",
"contents": [
{
"uri": "ui://example/card.html",
"mimeType": "text/html",
"text": "<p>示例应用</p>"
}
]
}
}
Field |
Type |
Description |
|---|---|---|
|
integer |
0 on success. |
|
string |
Requested resource URI. |
|
object (array of objects) |
Resource content blocks. |
|
string |
URI of this content block; do not assume every block matches the requested URI. |
|
string |
Optional MIME type; retain camelCase key spelling. |
|
string |
Text content; mutually exclusive with blob on MCP resource paths. |
|
string |
Base64-encoded content; mutually exclusive with text on MCP resource paths. |
|
JSON value |
Optional resource metadata, retained according to the provider contract. |
Error responses¶
HTTP / code |
Conditions and handling |
|---|---|
400 / 2 |
Invalid JSON, fields, URI, or selector. |
403 / 5 |
Current agent-use or corresponding privileges denied. |
404 / 3 |
Task outside the current scope, or tool/URI not bound. |
409 / 2 |
Task is failed, canceled, or rejected; app operations cannot continue. |
502 / 1 |
Invalid MCP resource provider response; distinct from the tool’s own is_error. |
503 / 15 |
Runtime or provider unavailable. |
500 / 1 |
Unclassified internal or persistence failure; message uses a localized generic description. |
Errors use localized message; authentication may additionally return string code/msg. See In-Task Knowledge Retrieval for recovery and environment states.