API overview

Updated at:

API standards and multilingual preset SDKs

The OpenAPI of this product (RdsAi/2025-05-07) uses the RPC signature style. We have encapsulated SDKs for common programming languages for developers. Developers can download the SDK to directly call this product's OpenAPI without worrying about technical details. If the existing SDK does not meet your needs, you can use the signature mechanism for self-signing integration. Since the details of self-signing are very complex, it may take around 5 business days. Therefore, we recommend joining our DingTalk service group (147535001692) and conducting signature integration under expert guidance.

Before using the API, you need to prepare your identity account and access key (AccessKey) to effectively access the API through client tools (such as SDK and CLI). For details, see Obtain an AccessKey.

Custom signature scenarios

If your business scenario has special requirements and you need to integrate the API through self-signing, we recommend consulting our technical support team first (DingTalk service group: 147535001692) to obtain professional guidance and ensure efficient integration.

Account and security preparation

Alibaba Cloud accounts have full administrative permissions over all resources. Once an AccessKey is compromised, all associated resources will be at risk of unauthorized access. To ensure security, it is recommended to create a RAM user with only API access permissions and configure its AccessKey, while configuring RAM policies based on the principle of least privilege (PoLP). Use the Alibaba Cloud account only in specific scenarios where Alibaba Cloud account permissions are explicitly required.

Skill

API

Title

Description

CreateSkill Create a skill Creates a user-defined skill.
UpdateSkill Update a skill Updates the information of a specified Skill.
ListSkill Get skill list Retrieves the custom skills of the current user and all system-preset skills.
GetSkill Get skill details Retrieves the details of a specified skill. You can retrieve your own skills or system preset skills.
DeleteSkill Delete a skill Deletes a specified Skill.

RDS AI assistant

API

Title

Description

ChatMessages Send a conversation message Sends a conversation message.
ModifyMessagesFeedbacks Modify message feedback Modifies message feedback.
ChatMessagesTaskStop Stop a conversation Stops a conversation.
GetConversations View historical conversations Queries the historical conversations of a user.
GetMessages View conversation messages Queries the details of specific conversation messages.
DescribeEventsList Query event list Queries a list of events.
ListCustomAgentTools Query user agent tool list Queries the list of Agent tools for a user.
UpdateCustomAgent Update a user agent Updates a Custom Agent.
GetCustomAgent Query a dedicated agent Queries a dedicated agent created by the user.
ListCustomAgent Query dedicated agent list Queries the list of dedicated agents created by the user.
DeleteCustomAgent Delete a user agent Deletes a dedicated agent created by the user.
CreateCustomAgent Create a user-specific agent Creates a user-specific agent.

Instances (RDS supabase)

API

Title

Description

CreateAppInstance Create an RDS AI application instance Creates an RDS AI application instance.
DeleteAppInstance Delete an RDS AI application instance Deletes an RDS AI application instance.
RestartInstance Restart an RDS AI application instance Restarts an ApsaraDB RDS AI application instance that is in the Running state.
StopInstance Pause an RDS AI application instance Pauses an RDS AI application instance that is in the Running state.
StartInstance Start an RDS AI application instance Starts an RDS AI application instance that is in the Stopped state.
ResetInstancePassword Reset RDS AI application instance passwords Resets the logon password and database access password of an RDS AI application instance.
DescribeAppInstanceAttribute Query RDS AI application instance details Queries the details of an RDS AI application instance.
DescribeAppInstances Query RDS AI application instances Queries a list of RDS AI application instances.
DescribeInstanceEndpoints Query endpoint information of an RDS AI application instance Queries the endpoint information of an RDS AI application instance.
DescribeInstanceAuthInfo Query authentication information of an RDS AI application instance Queries the authentication information of an RDS AI application instance.
ModifyInstanceAuthConfig Modify authentication configuration of an RDS AI application instance Modifies the authentication configuration of an RDS AI application instance.
DescribeInstanceStorageConfig Query storage configuration of an RDS AI application instance Queries the storage configuration of an RDS AI application instance.
ModifyInstanceStorageConfig Modify storage configuration of an RDS AI application instance Modifies the storage configuration of an RDS AI application instance.
ModifyInstanceConfig Modify general configurations of an RDS AI application instance Modifies the general configurations of an instance, such as network EIP and NAT configurations.

RAG Agent

API

Title

Description

ModifyInstanceRAGConfig Modify RAG agent configuration of an RDS AI application instance Modifies the RAG Agent configuration of an RDS AI application instance.
DescribeInstanceRAGConfig Query RAG agent configuration of an RDS AI application instance Queries the RAG Agent configuration of an RDS AI application instance.

Security

API

Title

Description

ModifyInstanceIpWhitelist Modify IP whitelist of an RDS AI application instance Modifies the IP whitelist of an RDS AI application instance.
DescribeInstanceIpWhitelist Query IP whitelist of an RDS AI application instance Queries the IP whitelist of an RDS AI application instance.
ModifyInstanceSSL Modify SSL configuration of an RDS AI application instance Modifies the SSL configuration of an RDS AI application instance.
ModifyInstancesSSL Batch modify SSL configurations of RDS AI application instances Batch modifies the SSL configurations of RDS AI application instances.
DescribeInstanceSSL Query SSL configuration of an RDS AI application instance Queries the SSL configuration of an RDS AI application instance.

RDS AI inspection

API

Title

Description

GetScheduledInstances Query all instance iDs in a specified scheduled inspection configuration Queries the list of all instance IDs included in a specified scheduled inspection configuration.
GetScheduledReports Query all inspection reports under a specified scheduled task Queries all inspection reports under a specified scheduled task, with support for filtering by time range and pagination.
ListScheduledTasks Query all inspection configurations of a user Queries the list of basic information about all inspection configurations under a specified user UID.
DeleteScheduledTask Delete a scheduled inspection configuration Deletes a specified inspection configuration.
ModifyScheduledTask Modify scheduled inspection configuration Modifies an existing inspection configuration.
CreateScheduledTask Create a scheduled inspection configuration Creates a scheduled inspection configuration for batch instances.
GetStandAloneReports Query individual inspection reports for non-scheduled tasks of a specified user Queries the list of individual inspection reports for all non-scheduled tasks under a specified user, with pagination support.
GetInspectionReport Retrieve inspection report details Retrieves the details of an inspection report by report ID.
CreateInspectionTask Create a batch instance inspection task Creates a batch instance inspection task.

RDS AI assistant ultimate edition

API

Title

Description

UpdateMOQuotaAlertThreshold Update alert threshold percentage for an API key Updates the alert threshold percentage for an API key.
UpdateApiKeyQuota Modify API key quota Modifies the quota of an API key.
ResetApiKey Reset API key Resets the API key.
RenameApiKey Rename a custom API key Renames a custom API key.
ModifyWhitelistIps Modify RDS AI assistant ultimate edition instance whitelist Modifies the IP whitelist of an RDS AI Assistant Ultimate Edition instance.
ListApiKeys Query custom API keys Queries custom API keys.
GetModelOperatorOrder Retrieve RDS AI assistant ultimate edition order information Retrieves order information for RDS AI Assistant Ultimate Edition.
DescribeWhitelistIps View RDS AI assistant ultimate edition instance whitelist Queries the whitelist of an RDS AI Assistant Ultimate Edition instance.
DescribeMonitorData Query instance monitoring data of an RDS AI Assistant Ultimate Edition instance Queries instance monitoring data of an RDS AI Assistant Ultimate Edition instance.
DescribeModelOperator View basic information and usage of RDS AI assistant ultimate edition Queries the basic information and usage of an RDS AI Assistant Ultimate Edition instance.
DescribeMOTokenUsageDetail Query token usage records of RDS AI assistant ultimate edition Queries the token usage records of RDS AI Assistant Ultimate Edition.
DeleteApiKey Delete a custom API key Deletes a custom API key.
CreateApiKey Create a custom API key Creates a custom API key.

Others

API

Title

Description

CreateSandboxTemplate Create a sandbox template Creates a sandbox template.
DeleteSandboxTemplate Delete a sandbox template Deletes a sandbox template.
DescribeCommonSandboxTemplates Query supported sandbox templates Queries the list of supported sandbox templates.
ModifySandboxTemplate Modify a sandbox template Modifies a sandbox template.
ModifyAppInstance Modify an RDS AI application instance Modifies the modules of an RDS AI application instance.
ResetInstanceKeys Reset keys of an RDS AI instance Resets the keys of an RDS AI instance, including AnonKey, ServiceKey, and JwtSecret. After the reset, the old keys and secret become invalid immediately. Ensure that your applications are updated accordingly.
DescribeSandboxTemplates Query sandbox templates available for sandbox creation Queries the list of sandbox templates used to create Supabase sandboxes.
EnableAgentRuntime Enable sandbox and edge routine capabilities for supabase Enables the sandbox and Edge Routine capabilities for a Supabase instance. Read the operation description before you call this operation.
DisableAgentRuntime Disable supabase sandbox and edge routine capabilities Disables the sandbox and Edge Routine capabilities of a Supabase instance. Note: This operation deletes all sandboxes and Edge Routines of the instance. Fully assess the business risks before performing this operation.