# Alibaba Cloud AgentCore API

> Alibaba Cloud AgentCore API on Apizie: 164 endpoints (Writes messages or text to a memory store. By default, sync is set to true, which means the operation…, Deletes multiple models in a specified workspace. If any model is in use, the entire batch request fails, Uploads skill ZIP packages in batches through OSS and returns the processing result for each skill, Converts an MCP to free-edit mode, …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://www.apizie.tech/v1/cloud:aliyun-agentcore/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `cloud:aliyun-agentcore`
- Category: Cloud
- Status: byok
- Source: https://api.alibabacloud.com/product/agentcore
- Page: https://www.apizie.tech/api/cloud/aliyun-agentcore
- OpenAPI: https://www.apizie.tech/api/cloud/aliyun-agentcore/openapi.json

Alibaba Cloud OpenAPI for AgentCore (agentcore, version 2026-08-04). Calls are signed with ACS3-HMAC-SHA256 using your AccessKey ID and secret.

## Endpoints

### Writes messages or text to a memory store. By default, sync is set to true, which means the operation…
`POST https://www.apizie.tech/v1/cloud:aliyun-agentcore/add-memories` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The ID of the AgentCore workspace |
| memoryStoreName | string | yes | The name of the MemoryStore |
| body | string | yes | The request body for writing to memory (JSON-encoded) |

### Deletes multiple models in a specified workspace. If any model is in use, the entire batch request fails
`POST https://www.apizie.tech/v1/cloud:aliyun-agentcore/batch-delete-models` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The workspace ID |
| body | string | no | The request body (JSON-encoded) |
| clientToken | string | no | The client token used for idempotence. This parameter is not currently supported |

### Uploads skill ZIP packages in batches through OSS and returns the processing result for each skill
`POST https://www.apizie.tech/v1/cloud:aliyun-agentcore/batch-upload-skills-via-oss` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The workspace ID |
| body | string | no | The request body (JSON-encoded) |

### Converts an MCP to free-edit mode
`POST https://www.apizie.tech/v1/cloud:aliyun-agentcore/convert-mcp-to-free-edit` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The AgentCore workspace ID |
| mcpServerId | string | yes | The MCP server ID |
| clientToken | string | no | The client token that is used to ensure request idempotence |

### Creates an IM channel for a specified agent and binds it to a publicly accessible ServiceEndpoint
`POST https://www.apizie.tech/v1/cloud:aliyun-agentcore/create-agent-imchannel` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The workspace ID |
| agentId | string | yes | The agent ID |
| body | string | no | The request body (JSON-encoded) |
| clientToken | string | no | The reserved idempotence token. The backend does not provide persistent idempotence guarantees in the current phase |

### Creates an AgentSpec in a specified workspace and generates the first draft version. Returns a resource…
`POST https://www.apizie.tech/v1/cloud:aliyun-agentcore/create-agent-spec` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The workspace ID |
| body | string | no | The request body (JSON-encoded) |

### Creates a new draft version for an existing AgentSpec. The AgentSpec must exist and must not have a draft…
`POST https://www.apizie.tech/v1/cloud:aliyun-agentcore/create-agent-spec-version` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The workspace ID |
| agentSpecName | string | yes | The unique name of the AgentSpec |
| body | string | no | The request body (JSON-encoded) |

### Creates a credential in a specified workspace for authentication when an agent accesses external services.…
`POST https://www.apizie.tech/v1/cloud:aliyun-agentcore/create-credential` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The workspace ID |
| body | string | no | The request body for creating a credential (JSON-encoded) |
| clientToken | string | no | Not supported |

### Creates a custom agent in a specified workspace. Container image and code package deployments are supported.…
`POST https://www.apizie.tech/v1/cloud:aliyun-agentcore/create-custom-agent` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The ID of the workspace to which the custom agent belongs |
| body | string | no | The JSON configuration of the custom agent. You must specify name, artifact, roleArn, and runtime (JSON-encoded) |
| clientToken | string | no | Idempotence is not currently guaranteed. Do not rely on this parameter to prevent duplicate requests |

### Creates an external agent in a specified workspace
`POST https://www.apizie.tech/v1/cloud:aliyun-agentcore/create-external-agent` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The workspace ID |
| body | string | no | The request body (JSON-encoded) |
| clientToken | string | no | The reserved idempotency token. The backend does not provide idempotency guarantees in the current phase |

### Creates the Bootstrap token and CMS configuration required to onboard a specified external agent
`POST https://www.apizie.tech/v1/cloud:aliyun-agentcore/create-external-agent-bootstrap-token` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The workspace ID |
| agentId | string | yes | The external agent ID |
| networkType | string | yes | The network type for onboarding. Valid values: INTRANET (internal network) and INTERNET (Internet) |

### Binds an external identity provider to a specified workspace for single sign-on and organization member…
`POST https://www.apizie.tech/v1/cloud:aliyun-agentcore/create-identity-provider` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The workspace ID |
| body | string | no | The request content for binding an external identity provider (JSON-encoded) |

### Issues a SCIM credential explicitly and returns the plaintext token only for the current call. A maximum of…
`POST https://www.apizie.tech/v1/cloud:aliyun-agentcore/create-identity-provider-scimcredential` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | Required. The ID of the target workspace. The request region must be the same as the region of the target workspace |

### Initiates a manual synchronization of an identity provider
`POST https://www.apizie.tech/v1/cloud:aliyun-agentcore/create-identity-provider-sync-job` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The ID of the AgentCore workspace to which the identity provider belongs |
| identityProviderType | string | yes | The type of the identity provider. DingTalk indicates DingTalk, and Feishu indicates Lark |

### Creates an image cache
`POST https://www.apizie.tech/v1/cloud:aliyun-agentcore/create-image-cache` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| regionId | string | yes | The product entry region, which is determined by the selected region endpoint |
| workspaceId | string | yes | The current routed workspace. The server verifies the account, region, and resource ownership. This parameter cannot be omitted or used to… |
| clientToken | string | yes | This parameter is required and cannot be empty. It is reserved to be compatible with the API. Currently, it does not provide the ability… |
| body | string | yes | The business parameters for creating an image cache (JSON-encoded) |

### Creates a managed agent in a specified workspace
`POST https://www.apizie.tech/v1/cloud:aliyun-agentcore/create-managed-agent` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The workspace ID |
| body | string | no | The request body (JSON-encoded) |
| clientToken | string | no | The reserved idempotency token. The backend does not provide idempotency guarantees in the current release |

### Creates an MCP service in a specified workspace. The creation is an asynchronous process. You can check…
`POST https://www.apizie.tech/v1/cloud:aliyun-agentcore/create-mcp` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The workspace ID |
| body | string | no | The request body (JSON-encoded) |
| clientToken | string | no | The client token that is used to ensure the idempotency of the request |

### Creates a long-term memory store in a specified workspace
`POST https://www.apizie.tech/v1/cloud:aliyun-agentcore/create-memory-store` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The AgentCore workspace ID |
| clientToken | string | no | The client token |
| body | string | yes | The MemoryStore creation request (JSON-encoded) |

### Creates a model configuration for model creation under a model connection in a specified workspace
`POST https://www.apizie.tech/v1/cloud:aliyun-agentcore/create-model` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The workspace ID |
| body | string | no | The request body (JSON-encoded) |
| clientToken | string | no | The client token used for idempotence. This parameter is not supported |

### Creates a model connection in a specified workspace and configures the upstream model service endpoint,…
`POST https://www.apizie.tech/v1/cloud:aliyun-agentcore/create-model-connection` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The workspace ID |
| body | string | no | The request body (JSON-encoded) |
| clientToken | string | no | The client token used for idempotence. This parameter is not supported |

### Creates a Skill in the specified workspace and generates a draft version that can be further edited. You can…
`POST https://www.apizie.tech/v1/cloud:aliyun-agentcore/create-skill-draft` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The workspace ID |
| body | string | no | The request body (JSON-encoded) |

### Creates a team in a specified workspace and configures user members and agent members at the same time.…
`POST https://www.apizie.tech/v1/cloud:aliyun-agentcore/create-team` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The workspace ID |
| body | string | no | The request body for creating a team (JSON-encoded) |
| clientToken | string | no | Not supported |

### Creates a user in a specified workspace. The username must be unique within the workspace, can contain only…
`POST https://www.apizie.tech/v1/cloud:aliyun-agentcore/create-user` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The workspace ID |
| body | string | no | The request body for creating a user (JSON-encoded) |
| clientToken | string | no | Not supported |

### Creates an AgentCore workspace control plane record. The server completes the state transition from…
`POST https://www.apizie.tech/v1/cloud:aliyun-agentcore/create-workspace` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| body | string | no | The request body for creating a workspace (JSON-encoded) |
| clientToken | string | no | The client idempotency token |

### Calls a specified model through a published model connection to verify whether the model call chain is…
`POST https://www.apizie.tech/v1/cloud:aliyun-agentcore/debug-model` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The workspace ID |
| modelId | string | yes | The model ID |
| body | string | no | The request body (JSON-encoded) |

### Deletes an IM channel of a specified agent
`POST https://www.apizie.tech/v1/cloud:aliyun-agentcore/delete-agent-imchannel` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The workspace ID |
| agentId | string | yes | The agent ID |
| imChannelId | string | yes | The IM channel ID |
| clientToken | string | no | The reserved idempotence token. The backend does not provide persistent idempotence guarantee in the current version |

### Deletes the specified AgentSpec and all its versions and metadata. The deletion is irreversible
`POST https://www.apizie.tech/v1/cloud:aliyun-agentcore/delete-agent-spec` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The workspace ID |
| agentSpecName | string | yes | The unique name of the AgentSpec |

### Deletes the draft version currently being edited for a specified AgentSpec and clears the draft version…
`POST https://www.apizie.tech/v1/cloud:aliyun-agentcore/delete-agent-spec-version` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The workspace ID |
| agentSpecName | string | yes | The unique name of the AgentSpec |

### Deletes a credential in a specified workspace and deletes the ciphertext hosted in the credential service.…
`POST https://www.apizie.tech/v1/cloud:aliyun-agentcore/delete-credential` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The workspace ID |
| credentialId | string | yes | The credential ID |
| clientToken | string | no | Not supported |

### Deletes a custom agent from a specified workspace. A successful request indicates that the deletion is…
`POST https://www.apizie.tech/v1/cloud:aliyun-agentcore/delete-custom-agent` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The ID of the workspace to which the custom agent belongs |
| agentId | string | yes | The unique identifier of the custom agent. You can obtain it from the response of CreateCustomAgent or ListCustomAgents |

### Deletes a specified external agent
`POST https://www.apizie.tech/v1/cloud:aliyun-agentcore/delete-external-agent` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The workspace ID |
| agentId | string | yes | The external agent ID |

### Disconnects the identity source integration of a workspace. For CustomSSO, this operation clears the shared…
`POST https://www.apizie.tech/v1/cloud:aliyun-agentcore/delete-identity-provider` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The workspace ID |
| identityProviderType | string | yes | The type of the external identity provider to be disconnected. Valid values: DingTalk and Feishu. The value must be the same as the… |
| clientToken | string | no | Not supported |

### 删除 SCIM 凭据
`POST https://www.apizie.tech/v1/cloud:aliyun-agentcore/delete-identity-provider-scimcredential` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | 必填，目标 Workspace 的标识；请求地域需与目标 Workspace 一致 |
| credentialId | string | yes | 删除时必填非空，使用凭据列表返回的 ID，不是 Token 明文 |

### Deletes an image cache
`POST https://www.apizie.tech/v1/cloud:aliyun-agentcore/delete-image-cache` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| regionId | string | yes | The product entry region, which is determined by the selected regional endpoint |
| workspaceId | string | yes | The current routed workspace. The server verifies the account, region, and resource ownership. This parameter cannot be omitted or used to… |
| imageId | string | yes | The ID of the cache record |

### Deletes a specified managed agent
`POST https://www.apizie.tech/v1/cloud:aliyun-agentcore/delete-managed-agent` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The workspace ID |
| agentId | string | yes | The managed agent ID |

### Deletes a specified MCP server. The deletion is an asynchronous process, and the MCP server is no longer…
`POST https://www.apizie.tech/v1/cloud:aliyun-agentcore/delete-mcp` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| mcpServerId | string | yes | The ID of the MCP server |
| workspaceId | string | yes | The ID of the workspace |

### Deletes a long-term memory based on the memory ID
`POST https://www.apizie.tech/v1/cloud:aliyun-agentcore/delete-memory` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The AgentCore workspace ID |
| memoryStoreName | string | yes | The MemoryStore name |
| memoryId | string | yes | The long-term memory ID |

### Asynchronously deletes a MemoryStore and all long-term memory within it
`POST https://www.apizie.tech/v1/cloud:aliyun-agentcore/delete-memory-store` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The AgentCore workspace ID |
| memoryStoreName | string | yes | The name of the MemoryStore |

### Deletes a model from a specified workspace. Models that are currently in use cannot be deleted
`POST https://www.apizie.tech/v1/cloud:aliyun-agentcore/delete-model` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The workspace ID |
| modelId | string | yes | The model ID |
| clientToken | string | no | The client token for idempotence. Not currently supported |

### Submits an asynchronous deletion task for a specified model connection. The connection cannot be deleted if…
`POST https://www.apizie.tech/v1/cloud:aliyun-agentcore/delete-model-connection` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The workspace ID |
| connectionId | string | yes | The model connection ID |
| clientToken | string | no | The client token for idempotence. Not currently supported |

### Deletes a skill and its related version data from a specified workspace. This operation is irreversible
`POST https://www.apizie.tech/v1/cloud:aliyun-agentcore/delete-skill` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The workspace ID |
| skillName | string | yes | The skill name |

### Deletes the draft version currently being edited for a specified Skill
`POST https://www.apizie.tech/v1/cloud:aliyun-agentcore/delete-skill-draft` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The workspace ID |
| skillName | string | yes | The Skill name |

### Deletes a team from a specified workspace. Deleting a team does not delete the users or agents within it.…
`POST https://www.apizie.tech/v1/cloud:aliyun-agentcore/delete-team` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The workspace ID |
| teamId | string | yes | The team ID |
| clientToken | string | no | Not supported |

### Deletes a user from a specified workspace. A user cannot be deleted while the user is still a member of any…
`POST https://www.apizie.tech/v1/cloud:aliyun-agentcore/delete-user` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The workspace ID |
| agentCoreUserId | string | yes | The user ID |
| clientToken | string | no | Not supported |

### Deletes the control plane record of a specified workspace. The server completes the state transition from…
`POST https://www.apizie.tech/v1/cloud:aliyun-agentcore/delete-workspace` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The ID of the workspace to delete |

### Disables a QoderCLI Connector in a specified workspace. The Connector can be disabled only when no Agent is…
`POST https://www.apizie.tech/v1/cloud:aliyun-agentcore/disable-connector` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The workspace ID |
| connectorName | string | yes | The Connector name. Currently, only qodercli is supported |

### Retrieves the presigned OSS download URL of a specified AgentSpec to download the AgentSpec ZIP package
`GET https://www.apizie.tech/v1/cloud:aliyun-agentcore/download-agent-spec-via-oss` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The workspace ID |
| agentSpecName | string | yes | The unique name of the AgentSpec |
| agentSpecVersion | string | no | The version number. If you do not specify this parameter, the version associated with the latest tag is downloaded |

### Retrieves a pre-signed OSS download URL for a specified Skill version, which is used to download the…
`GET https://www.apizie.tech/v1/cloud:aliyun-agentcore/download-skill-version-via-oss` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The workspace ID |
| skillName | string | yes | The Skill name |
| skillVersion | string | yes | The version number |

### Enables a QoderCLI Connector in a specified workspace. The request must include the site, API key, and at…
`POST https://www.apizie.tech/v1/cloud:aliyun-agentcore/enable-connector` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The workspace ID |
| connectorName | string | yes | The Connector name. Currently, only qodercli is supported |
| body | string | yes | The enable request body (JSON-encoded) |

### Skips the regular review process and forcibly publishes a specified Skill version
`POST https://www.apizie.tech/v1/cloud:aliyun-agentcore/force-publish-skill-version` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The workspace ID |
| skillName | string | yes | The Skill name |
| skillVersion | string | yes | The Skill version number |
| body | string | no | The request body (JSON-encoded) |

### Retrieves the download URL for the saved code package of an agent
`GET https://www.apizie.tech/v1/cloud:aliyun-agentcore/get-agent-code-package-download-url` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The workspace ID |
| agentId | string | yes | The custom agent ID |

### Retrieves the OSS RAM authorization URL for the agent code package
`GET https://www.apizie.tech/v1/cloud:aliyun-agentcore/get-agent-code-package-oss-ram-authorize-url` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The workspace ID |
| ossBucketName | string | yes | The name of the source OSS bucket |

### Retrieves the upload URL for an agent code package
`POST https://www.apizie.tech/v1/cloud:aliyun-agentcore/get-agent-code-package-upload-url` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The workspace ID |
| body | string | yes | The request body (JSON-encoded) |

### Queries the details of a specified agent IM channel
`GET https://www.apizie.tech/v1/cloud:aliyun-agentcore/get-agent-imchannel` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The workspace ID |
| agentId | string | yes | The agent ID |
| imChannelId | string | yes | The IM channel ID |

### Queries the governance details of a specified AgentSpec, including basic information, governance pointers,…
`GET https://www.apizie.tech/v1/cloud:aliyun-agentcore/get-agent-spec` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The workspace ID |
| agentSpecName | string | yes | The unique name of the AgentSpec |

### Retrieves the OSS presigned upload URL and object name required to import an AgentSpec ZIP package. After…
`GET https://www.apizie.tech/v1/cloud:aliyun-agentcore/get-agent-spec-import-file-url` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The workspace ID |
| contentType | string | no | The Content-Type of the uploaded file. The client must use the same value in the PUT request as the one returned in the response |

### Queries the full content of the latest version of a specified AgentSpec for editing or viewing
`GET https://www.apizie.tech/v1/cloud:aliyun-agentcore/get-agent-spec-latest` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The workspace ID |
| agentSpecName | string | yes | The AgentSpec name |

### Queries the complete content of a specified AgentSpec version, including the manifest content, resource…
`GET https://www.apizie.tech/v1/cloud:aliyun-agentcore/get-agent-spec-version` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The workspace ID |
| agentSpecName | string | yes | The unique name of the AgentSpec |
| agentSpecVersion | string | yes | The version number |

### Queries the details of a specified credential and returns the list of agents bound to the credential. The…
`GET https://www.apizie.tech/v1/cloud:aliyun-agentcore/get-credential` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The workspace ID |
| credentialId | string | yes | The credential ID |

### Queries the details of a custom agent in a specified workspace, including deployment configurations, the…
`GET https://www.apizie.tech/v1/cloud:aliyun-agentcore/get-custom-agent` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The ID of the workspace to which the custom agent belongs |
| agentId | string | yes | The unique identifier of the custom agent, which can be obtained from the response of CreateCustomAgent or ListCustomAgents |

### Queries the details of a specified external agent
`GET https://www.apizie.tech/v1/cloud:aliyun-agentcore/get-external-agent` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The workspace ID |
| agentId | string | yes | The external agent ID |

### Queries the available access network types for a specified external agent
`GET https://www.apizie.tech/v1/cloud:aliyun-agentcore/get-external-agent-bootstrap-options` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The workspace ID |
| agentId | string | yes | The external agent ID |

### Queries the binding and expected configuration of a specified identity provider. When CustomSSO is…
`GET https://www.apizie.tech/v1/cloud:aliyun-agentcore/get-identity-provider` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The workspace ID |
| identityProviderType | string | yes | The type of the external identity provider. Valid values: DingTalk and Feishu |

### Queries the actual SCIM receiving configuration, the expected AC synchronization switch, and the status of…
`GET https://www.apizie.tech/v1/cloud:aliyun-agentcore/get-identity-provider-scim` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | Required. The ID of the target workspace. The request region must be the same as the region of the target workspace |

### 查询 SAML 服务提供商信息
`GET https://www.apizie.tech/v1/cloud:aliyun-agentcore/get-identity-provider-service-provider` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | 必填，目标 Workspace 的标识；请求地域需与目标 Workspace 一致 |
| identityProviderType | string | yes | 本接口仅支持 CustomSSO |
| protocol | string | yes | 查询参数必填，仅支持精确值 SAML；响应返回 SAML |

### Queries an identity provider synchronization task
`GET https://www.apizie.tech/v1/cloud:aliyun-agentcore/get-identity-provider-sync-job` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The ID of the AgentCore workspace to which the identity provider belongs |
| identityProviderType | string | yes | The identity provider type. DingTalk indicates DingTalk, and Feishu indicates Lark |
| taskId | string | yes | The local task ID of AgentCore returned by CreateIdentityProviderSyncJob. It is not the synchronizationJobId of AgentIdentity. The same… |

### Queries the synchronization scope of an identity provider
`GET https://www.apizie.tech/v1/cloud:aliyun-agentcore/get-identity-provider-sync-scope` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The ID of the AgentCore workspace to which the identity provider belongs |
| identityProviderType | string | yes | The type of the identity provider. DingTalk indicates DingTalk, and Feishu indicates Lark |

### Queries the details of an image cache
`GET https://www.apizie.tech/v1/cloud:aliyun-agentcore/get-image-cache` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| regionId | string | yes | The product entry region, which is determined by the selected region endpoint |
| workspaceId | string | yes | The current routed workspace. The server verifies the account, region, and resource ownership. This parameter cannot be omitted or used to… |
| imageId | string | yes | The cache record ID |

### Queries the details of a specified managed agent
`GET https://www.apizie.tech/v1/cloud:aliyun-agentcore/get-managed-agent` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The workspace ID |
| agentId | string | yes | The managed agent ID |

### Queries the details of a specified MCP server, including the address, type, status, authentication…
`GET https://www.apizie.tech/v1/cloud:aliyun-agentcore/get-mcp` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The AgentCore workspace ID |
| mcpServerId | string | yes | The MCP server ID |

### Queries the details of an MCP marketplace template
`GET https://www.apizie.tech/v1/cloud:aliyun-agentcore/get-mcp-market-item` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The AgentCore workspace ID |
| marketItemId | string | yes | The MCP marketplace template ID |

### Queries a long-term memory by memory ID
`GET https://www.apizie.tech/v1/cloud:aliyun-agentcore/get-memory` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The AgentCore workspace ID |
| memoryStoreName | string | yes | The MemoryStore name |
| memoryId | string | yes | The long-term memory ID |

### Queries the public information and current status of a MemoryStore in a specified workspace
`GET https://www.apizie.tech/v1/cloud:aliyun-agentcore/get-memory-store` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The AgentCore workspace ID |
| memoryStoreName | string | yes | The MemoryStore name |

### Queries the task ID returned by the asynchronous AddMemories operation
`GET https://www.apizie.tech/v1/cloud:aliyun-agentcore/get-memory-task` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The AgentCore workspace ID |
| memoryStoreName | string | yes | The MemoryStore name |
| taskId | string | yes | The task ID returned by AddMemories |

### Queries the detailed configuration and region of a model in a specified workspace
`GET https://www.apizie.tech/v1/cloud:aliyun-agentcore/get-model` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The workspace ID |
| modelId | string | yes | The model ID |

### Queries the detailed configuration, credential configuration status, publish status, and region of a…
`GET https://www.apizie.tech/v1/cloud:aliyun-agentcore/get-model-connection` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The workspace ID |
| connectionId | string | yes | The model connection ID |

### Queries the details of a specified service endpoint, including target routing, access URLs, authentication…
`GET https://www.apizie.tech/v1/cloud:aliyun-agentcore/get-service-endpoint` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The workspace ID |
| serviceEndpointId | string | yes | The service endpoint ID |

### Queries the currently active API key and its invocation method for a service endpoint in a specified workspace
`POST https://www.apizie.tech/v1/cloud:aliyun-agentcore/get-service-endpoint-api-key` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The ID of the workspace to which the service endpoint belongs |
| serviceEndpointId | string | yes | The ID of the service endpoint for which to query the API key |

### Queries the basic information, version status, labels, visibility scope, and version list of a specified Skill
`GET https://www.apizie.tech/v1/cloud:aliyun-agentcore/get-skill-detail` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The workspace ID |
| skillName | string | yes | The Skill name |

### Retrieves the OSS presigned upload URL and object name required to import a Skill ZIP package. After the…
`GET https://www.apizie.tech/v1/cloud:aliyun-agentcore/get-skill-import-file-url` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The workspace ID |
| contentType | string | no | The Content-Type of the uploaded file. Default value: application/zip |

### Queries the complete details of a specified Skill version, including version metadata, Skill content, and…
`GET https://www.apizie.tech/v1/cloud:aliyun-agentcore/get-skill-version-detail` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The workspace ID |
| skillName | string | yes | The Skill name |
| skillVersion | string | yes | The version number |

### Queries the details of a specified team. The response includes the complete attributes and team roles of…
`GET https://www.apizie.tech/v1/cloud:aliyun-agentcore/get-team` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The workspace ID |
| teamId | string | yes | The team ID |

### Queries the details of a specific user in a specified workspace. Returns an error if the user does not exist
`GET https://www.apizie.tech/v1/cloud:aliyun-agentcore/get-user` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The workspace ID |
| agentCoreUserId | string | yes | The user ID |

### Queries the details of a workspace by workspace ID, including the lifecycle status, CMS Workspace,…
`GET https://www.apizie.tech/v1/cloud:aliyun-agentcore/get-workspace` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The workspace ID |

### Queries the ACR RAM authorization URL of a workspace
`GET https://www.apizie.tech/v1/cloud:aliyun-agentcore/get-workspace-acr-ram-authorize-url` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The workspace ID |
| acrInstanceId | string | yes | The ID of the ACR Enterprise instance |
| namespace | string | yes | The target ACR namespace, which corresponds to artifact.container.namespace of the agent. This is not a Kubernetes namespace. This… |
| repository | string | yes | The name of the target repository, which corresponds to artifact.container.repo of the agent. The name cannot contain tags, namespaces, or… |

### Queries the RAM authorization URL for mounting AgenticFS in a workspace
`GET https://www.apizie.tech/v1/cloud:aliyun-agentcore/get-workspace-agentic-fs-mount-ram-authorize-url` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The workspace ID |
| server | string | yes | The domain name of the target access point. Obtain this value from the DomainName field in the NAS ListAccessPoints response. Do not… |
| fileSystemId | string | yes | The ID of the NAS file system to which the target access point belongs. This parameter corresponds to the server and accessPointId… |
| accessPointId | string | yes | The ID of the target NAS access point. This parameter corresponds to the server and fileSystemId parameters |

### Queries the plug-in status of a specified workspace
`GET https://www.apizie.tech/v1/cloud:aliyun-agentcore/get-workspace-plugin` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The workspace ID |
| pluginName | string | yes | The plug-in name. Valid values: collaboration, agentloop |

### Installs an MCP marketplace template
`POST https://www.apizie.tech/v1/cloud:aliyun-agentcore/install-mcp-market-item` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The AgentCore workspace ID |
| marketItemId | string | yes | The MCP marketplace template ID |
| templateVersion | string | yes | The template version to install. You can call GetMcpMarketItem to query available versions |
| body | string | no | The MCP configuration submitted during template installation. The configuration must conform to the input schema of the template… |
| clientToken | string | no | The client token that is used to ensure the idempotence of the request |

### Installs a plugin for a specified AgentCore workspace. Currently, only the collaboration plugin is…
`POST https://www.apizie.tech/v1/cloud:aliyun-agentcore/install-workspace-plugin` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The workspace ID |
| pluginName | string | yes | The plugin name. Currently, only collaboration is supported |
| body | string | no | The request body for installing a plugin (JSON-encoded) |
| clientToken | string | no | The client idempotency token |

### Queries the runtime environments supported for code deployment
`GET https://www.apizie.tech/v1/cloud:aliyun-agentcore/list-agent-code-runtimes` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The workspace ID |
| maxResults | integer | no | The maximum number of records per page |
| nextToken | string | no | The token for the next page |

### Queries the list of IM channels for a specified agent
`GET https://www.apizie.tech/v1/cloud:aliyun-agentcore/list-agent-imchannels` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The workspace ID |
| agentId | string | yes | The agent ID |
| channelType | string | no | The IM channel type. Valid values: DINGTALK: DingTalk. FEISHU: Lark. WECOM: WeCom |
| status | string | no | The IM channel status. Valid values: CREATING: The channel is being created. READY: The channel is ready. UPDATING: The channel is being… |
| maxResults | integer | no | The maximum number of entries to return per page. Default value: 20. Valid values: 1 to 100 |
| nextToken | string | no | The pagination token. You do not need to specify this parameter for the first request. For subsequent requests, use the nextToken value… |

### Queries AgentSpec resources in a specified workspace by using paging, and supports name-based search,…
`GET https://www.apizie.tech/v1/cloud:aliyun-agentcore/list-agent-specs` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The workspace ID |
| agentSpecName | string | no | The AgentSpec name used as a search keyword. This parameter is used together with the search parameter |
| search | string | no | The search mode. Valid values: accurate: exact match. blur: fuzzy match. Default value: blur |
| orderBy | string | no | The field by which to sort the results. Set the value to download_count to sort by download count. By default, results are sorted by… |
| owner | string | no | The owner used to filter the results |
| scope | string | no | The visibility scope used to filter the results. Valid values: PUBLIC PRIVATE |
| bizTag | string | no | The business tag used for fuzzy filtering |
| pageNo | integer | no | The page number. Pages start from 1. Default value: 1 |
| pageSize | integer | no | The number of entries per page. Default value: 10. Maximum value: 50 |
| withCapabilities | string | no | Specifies whether to return the Skills and McpServers lists. Default value: false |

### Queries the teams to which specified agents belong. Specify the agent IDs by using agentIds to retrieve the…
`POST https://www.apizie.tech/v1/cloud:aliyun-agentcore/list-agent-teams` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The workspace ID |
| body | string | no | The request parameters for querying the list of agent teams (JSON-encoded) |

### Queries the available official models and enterprise models for an enabled QoderCLI Connector. The service…
`GET https://www.apizie.tech/v1/cloud:aliyun-agentcore/list-connector-models` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The workspace ID |
| connectorName | string | yes | The Connector name. Currently, only qodercli is supported |
| connectorKeyId | string | no | The Connector Key ID. This parameter is not supported in the current version |
| maxResults | integer | no | The page size. This parameter is not supported in the current version |
| nextToken | string | no | The next page token. This parameter is not supported in the current version |

### Queries the list of connectors supported by a specified workspace, including their status, number of bound…
`GET https://www.apizie.tech/v1/cloud:aliyun-agentcore/list-connectors` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The workspace ID |
| maxResults | integer | no | The page size. The current version does not support this parameter |
| nextToken | string | no | The next page token. The current version does not support this parameter |

### Performs a paged query for credentials in a specified workspace. Filters by type using credentialType,…
`GET https://www.apizie.tech/v1/cloud:aliyun-agentcore/list-credentials` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The workspace ID |
| credentialType | string | no | Filters by credential type. Currently, only apiKey is supported |
| name | string | no | Filters by credential name |
| nameLike | string | no | The filter condition for fuzzy matching by credential name |
| maxResults | integer | no | The maximum number of records to return per page. Valid values: 1 to 100. If this parameter is not specified, 10 records are returned by… |
| nextToken | string | no | The cursor used to query the next page. Do not specify this parameter in the first call. For subsequent calls, specify the nextToken… |

### Performs a paged query for paging through the custom agent summary in a specified workspace. For the…
`GET https://www.apizie.tech/v1/cloud:aliyun-agentcore/list-custom-agents` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The ID of the workspace to which the custom agent belongs |
| maxResults | integer | no | The maximum number of entries to return on each page. Valid values: 1 to 100. If this parameter is omitted or set to 0, the default value… |
| nextToken | string | no | The opaque token for querying the next page. Omit this parameter in the first request. For subsequent requests, use the nextToken returned… |

### Queries the list of external agents in a specified workspace
`GET https://www.apizie.tech/v1/cloud:aliyun-agentcore/list-external-agents` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The workspace ID |
| maxResults | integer | no | The maximum number of entries to return per page. Default value: 20. Valid values: 1 to 100 |
| nextToken | string | no | The pagination token. You do not need to specify this parameter for the first call. For subsequent calls, use the nextToken value returned… |

### Queries the departments of an identity provider by page
`GET https://www.apizie.tech/v1/cloud:aliyun-agentcore/list-identity-provider-departments` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The ID of the AgentCore workspace to which the identity provider belongs |
| identityProviderType | string | yes | The type of the identity provider. DingTalk indicates DingTalk, and Feishu indicates Lark |
| parentDepartmentId | string | no | Queries the direct child departments of the specified department. If this parameter is not specified or is empty, the root hierarchy is… |
| maxResults | integer | no | The number of departments to return per page. Valid values: 1 to 50. Default value: 50 |
| nextToken | string | no | The nextToken returned from the previous page. Do not specify this parameter for the first query. When continuing pagination, keep the… |

### Queries the complete summary list of up to two SCIM credentials in the shared user pool, without returning…
`GET https://www.apizie.tech/v1/cloud:aliyun-agentcore/list-identity-provider-scimcredentials` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The ID of the target workspace. This parameter is required. The request region must be the same as the region of the target workspace |

### Queries the summary of existing identity provider bindings for a workspace, including CustomSSO. Returns…
`GET https://www.apizie.tech/v1/cloud:aliyun-agentcore/list-identity-providers` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The workspace ID |
| maxResults | integer | no | The maximum number of records to return per page. Valid values: 1 to 100. Default value: 10 |
| nextToken | string | no | The cursor for querying the next page. Do not specify this parameter for the first call. For subsequent calls, specify the nextToken value… |

### Queries image caches
`GET https://www.apizie.tech/v1/cloud:aliyun-agentcore/list-image-caches` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| regionId | string | yes | The product entry region, which is determined by the selected region endpoint |
| workspaceId | string | yes | The current routed workspace. The server verifies the account, region, and resource ownership. This parameter cannot be omitted or used to… |
| imageRefContains | string | no | Performs a case-insensitive literal substring search on the complete source image reference in the registry/repository:tag format, where… |
| acrInstanceId | string | no | The ID of the source ACR Enterprise instance. The match must be exact. Empty character strings are invalid |
| registry | string | no | The domain name of the source repository. The match is case-insensitive and must be exact. Do not include the protocol, path, or tag.… |
| namespace | string | no | The source namespace. The match is case-sensitive and must be exact. Empty strings are invalid |
| repository | string | no | The name of the repository under the namespace. The match is case-sensitive and must be exact. Do not include the namespace. If this… |
| tag | string | no | The tag of the source image. The match is case-sensitive and must be exact. The latest tag is not inferred. Empty strings are invalid |
| digest | string | no | The complete image digest in the sha256: format followed by a 64-character lowercase hexadecimal string. The format is verified by the… |
| status | string | no | Filters the results by a single cache status. Omit this parameter to query all statuses |
| nextToken | string | no | Omit this parameter for the first request. For subsequent requests, pass the nextToken value from the previous response exactly as… |
| maxResults | integer | no | The maximum number of results to return. If this parameter is not provided or is set to 0, the default value is 20. If the value exceeds… |

### Queries the list of managed agents in a specified workspace
`GET https://www.apizie.tech/v1/cloud:aliyun-agentcore/list-managed-agents` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The workspace ID |
| maxResults | integer | no | The maximum number of entries to return per page. Default value: 20. Valid values: 1 to 100 |
| nextToken | string | no | The pagination token. Leave this parameter empty for the first request. For subsequent requests, use the nextToken value returned in the… |

### Queries MCP marketplace templates
`GET https://www.apizie.tech/v1/cloud:aliyun-agentcore/list-mcp-market-items` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The AgentCore workspace ID |
| keyword | string | no | The keyword used to filter MCP marketplace templates |
| officialTag | string | no | The official usage tag |
| mcpType | string | no | The MCP type |
| maxResults | integer | no | The maximum number of records to return in this query |
| nextToken | string | no | The pagination token used to retrieve the next page of results |

### Queries the list of tools exposed by a specified MCP service and their input/output schemas
`GET https://www.apizie.tech/v1/cloud:aliyun-agentcore/list-mcp-tools` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The AgentCore workspace ID |
| mcpServerId | string | yes | The MCP service ID |
| maxResults | integer | no | The maximum number of results to return per request. Default value: 10. Maximum value: 100 |
| nextToken | string | no | The pagination token |

### Queries MCP services and their configurations and statuses in a specified workspace by using paging
`GET https://www.apizie.tech/v1/cloud:aliyun-agentcore/list-mcps` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The AgentCore workspace ID |
| maxResults | integer | no | The maximum number of entries per page |
| nextToken | string | no | The pagination token for the next page |
| name | string | no | The MCP service name or service ID. Used together with SearchType |
| searchType | string | no | The name matching method. Takes effect only when Name is specified. Valid values: accurate: exact match. blur: fuzzy match. Default value:… |
| officialTag | string | no | Filters results by official usage tag |
| customTag | string | no | Filters results by custom tag. The tag must be an exact match |
| usageActive | string | no | Specifies whether the service is still bound by the official template usage |

### Performs a paged query on long-term memory records. The results can be filtered independently by user ID,…
`GET https://www.apizie.tech/v1/cloud:aliyun-agentcore/list-memories` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The AgentCore workspace ID |
| memoryStoreName | string | yes | The MemoryStore name |
| userId | string | no | The user ID. If you do not specify this parameter, all users are matched. The value must be 1 to 128 bytes in length and encoded in UTF-8.… |
| agentId | string | no | The agent ID. If you do not specify this parameter, all agents are matched. The value must be 1 to 128 bytes in length and encoded in… |
| sessionId | string | no | The session ID. If you do not specify this parameter, all sessions are matched. The value must be 1 to 128 bytes in length and encoded in… |
| maxResults | integer | no | The maximum number of records per page. Default value: 50. Valid values: 1 to 100 |
| nextToken | string | no | The pagination token for the next page |

### Performs a paging query for raw messages by exact scope. SessionId is required, and at least one of UserId…
`GET https://www.apizie.tech/v1/cloud:aliyun-agentcore/list-memory-session-messages` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The AgentCore workspace ID |
| memoryStoreName | string | yes | The MemoryStore name |
| userId | string | no | The user ID. You must specify at least one of UserId and AgentId. The length is limited to 1 to 128 UTF-8 bytes. The forward slash (/) and… |
| agentId | string | no | The agent ID. You must specify at least one of AgentId and UserId. The length is limited to 1 to 128 UTF-8 bytes. The forward slash (/)… |
| sessionId | string | yes | The session ID. The length is limited to 1 to 128 UTF-8 bytes. The forward slash (/) and asterisk (*) are not allowed |
| maxResults | integer | no | The maximum number of records per page. Default value: 200. Valid values: 1 to 500 |
| nextToken | string | no | The pagination token for the next page |

### Performs a paging query for sessions in a MemoryStore. You can filter the sessions independently by user ID…
`GET https://www.apizie.tech/v1/cloud:aliyun-agentcore/list-memory-sessions` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The AgentCore workspace ID |
| memoryStoreName | string | yes | The MemoryStore name |
| userId | string | no | The user ID. If you do not specify this parameter, all users are matched. The value must be 1 to 128 bytes in length and cannot contain… |
| agentId | string | no | The agent ID. If you do not specify this parameter, all agents are matched. The value must be 1 to 128 bytes in length and cannot contain… |
| maxResults | integer | no | The maximum number of records per page. Default value: 100. Valid values: 1 to 100 |
| nextToken | string | no | The pagination token for the next page |

### Performs a paged query for MemoryStores in a specified workspace with paging
`GET https://www.apizie.tech/v1/cloud:aliyun-agentcore/list-memory-stores` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The AgentCore workspace ID |
| maxResults | integer | no | The maximum number of records per page. Default value: 10. Valid values: 1 to 100 |
| nextToken | string | no | The pagination token for the next page |

### Queries model connections in a specified workspace with paging. Supports filtering by name, provider type,…
`GET https://www.apizie.tech/v1/cloud:aliyun-agentcore/list-model-connections` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The workspace ID |
| maxResults | integer | no | The number of records per page. Valid values: 0 to 100. If this parameter is not set or is set to 0, the default value 10 is used |
| nextToken | string | no | The pagination token. Pass the token returned in the previous query. An empty response indicates that no more pages are available |
| name | string | no | The model connection name. The name must be 1 to 128 non-whitespace characters in length |
| searchType | string | no | The name matching mode. Takes effect only when Name is set. Valid values: accurate (exact match), blur (fuzzy match). Default value: blur |
| providerType | string | no | The model provider type used to filter model connections |
| protocol | string | no | The invocation protocol used to filter model connections |
| includeModels | string | no | Specifies whether to return associated model summaries for each model connection. By default, model summaries are not returned |

### Queries models in a specified workspace by using paging. Supports filtering by model connection and model name
`GET https://www.apizie.tech/v1/cloud:aliyun-agentcore/list-models` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The workspace ID |
| maxResults | integer | no | The number of results per page. Valid values: 0 to 100. If this parameter is not set or set to 0, the default value 10 is used |
| nextToken | string | no | The pagination token. Pass the token returned from the previous query. An empty response indicates that no more pages are available |
| connectionId | string | no | The model connection ID used to filter models |
| modelName | string | no | The upstream model name |

### Queries the providers supported by the built-in model catalog of AgentCore and their default service…
`GET https://www.apizie.tech/v1/cloud:aliyun-agentcore/list-predefined-model-providers` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |

### Queries the models and their capabilities in the built-in model catalog of AgentCore for a specified provider
`GET https://www.apizie.tech/v1/cloud:aliyun-agentcore/list-predefined-models` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| providerType | string | yes | The model provider type |

### Queries the list of active sessions in the sandbox of a specified managed agent by paging, and returns the…
`GET https://www.apizie.tech/v1/cloud:aliyun-agentcore/list-sandbox-sessions` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The workspace ID |
| agentId | string | yes | The managed agent ID |
| sandboxId | string | yes | The sandbox ID. You can call ListSandboxes to query the sandbox ID |
| maxResults | integer | no | The maximum number of records per page. Default value: 20 |
| nextToken | string | no | The pagination token for querying the next page |

### Queries the list of sandboxes for a managed agent in a specified workspace. You can filter results by…
`GET https://www.apizie.tech/v1/cloud:aliyun-agentcore/list-sandboxes` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The workspace ID |
| agentId | string | yes | The managed agent ID |
| searchText | string | no | Performs a case-insensitive fuzzy search by sandbox ID fragment |
| sessionId | string | no | Performs a case-insensitive fuzzy search by active session ID fragment |
| maxResults | integer | no | The maximum number of records per page. Default value: 20 |
| nextToken | string | no | The pagination token for querying the next page. When paginating, keep workspaceId, agentId, searchText, sessionId, and maxResults unchanged |

### Queries service endpoints in a specified workspace with paging and supports filtering by target type, agent,…
`GET https://www.apizie.tech/v1/cloud:aliyun-agentcore/list-service-endpoints` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The workspace ID |
| targetType | string | no | Filters the results by target type. Valid values: AGENT_VERSION and TEAM_COLLABORATION |
| agentId | string | no | Filters the results by target agent ID |
| agentVersion | string | no | Filters the results by target agent version |
| resourceBindingId | string | no | Filters the results by the workspace resource binding ID of the target collaboration component |
| collaborationComponent | string | no | Filters the results by collaboration component type. Valid values: MATRIX_CLIENT, MATRIX_FEDERATION, and ELEMENT_WEB |
| status | string | no | Filters the results by service endpoint status. Valid values: CREATING, READY, UPDATING, DEGRADED, DISABLED, and DELETING |
| maxResults | integer | no | The maximum number of records to return per page. Valid values: 1 to 100. Default value: 20 |
| nextToken | string | no | The cursor for querying the next page. Do not specify this parameter for the first call. For subsequent calls, specify the nextToken value… |

### Queries skill reference relationships
`GET https://www.apizie.tech/v1/cloud:aliyun-agentcore/list-skill-references` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The workspace ID |
| skillName | string | yes | The skill name |
| pageNo | integer | no | The page number. Pages start from 1. Default value: 1 |
| pageSize | integer | no | The number of entries per page. If not specified, the default value on the server is used |
| selectorType | string | no | The reference selector type used for filtering. Valid values: LABEL and VERSION |
| selectorValue | string | no | The reference selector value used for filtering. Valid values: latest, a named label, HEAD, or a specific version |

### Performs a paged query of Skills in a specified workspace and returns basic Skill information, version…
`GET https://www.apizie.tech/v1/cloud:aliyun-agentcore/list-skills` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The workspace ID |
| skillName | string | no | The filter keyword |
| search | string | no | The search mode. Valid values: accurate: exact match. blur: fuzzy match |
| orderBy | string | no | The field by which to sort results. The value download_count is supported. Default value: gmt_modified |
| owner | string | no | Filters results by owner |
| scope | string | no | Filters results by visibility. Valid values: PUBLIC PRIVATE |
| pageNo | integer | no | The page number. Default value: 1 |
| pageSize | integer | no | The number of entries per page. Default value: 10. Maximum value: 50 |
| maxResults | integer | no | The maximum number of entries per page |
| nextToken | string | no | The pagination token for the next page |

### Queries teams in a specified workspace by using paging. You can use nameLike to filter teams by fuzzy…
`GET https://www.apizie.tech/v1/cloud:aliyun-agentcore/list-teams` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://agentcore.ap-southeast-1.aliyuncs.com |
| workspaceId | string | yes | The workspace ID |
| nameLike | string | no | The filter condition for fuzzy matching the team name |
| maxResults | integer | no | The maximum number of records to return per page. Valid values: 1 to 100. If this parameter is not specified, 10 records are returned by… |
| nextToken | string | no | The pagination token for querying the next page. Do not specify this parameter for the first call. For subsequent calls, specify the… |

…and 44 more. See the OpenAPI spec.

## Example
```
curl "https://www.apizie.tech/v1/cloud:aliyun-agentcore/add-memories" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Alibaba Cloud AgentCore API?
Create a free Apizie key, then send POST https://www.apizie.tech/v1/cloud:aliyun-agentcore/add-memories with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Alibaba Cloud AgentCore API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Alibaba Cloud AgentCore itself also needs your own key from aliyuncs.com.

### Can AI agents use the Alibaba Cloud AgentCore API?
Yes. Add the Apizie MCP server (https://www.apizie.tech/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key cloud:aliyun-agentcore.

### What is the status of the Alibaba Cloud AgentCore API?
Needs your own provider key (bring your own key)