DescribeSkills - Cloud Phone - Alibaba Cloud Documentation Center

Queries skill information.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request syntax

POST  HTTP/1.1

Request parameters

Parameter	Type	Required	Description	Example
Keyword	string	No	The keyword in the skill name or skill description.	weather
Type	string	No	The skill type. Valid values: Custom : Custom skill. System : System skill.	System
PageNumber	integer	No	The page number. Default value: 1.	1
PageSize	integer	No	The number of entries per page. Default value: 10. Maximum value: 100.	10
Language	string	No	The language type. The skill description is returned in the specified language. Valid values: en: English. zh-CN: Chinese. Valid values: en : English. zh-CN : Chinese.	zh-CN
SkillId	string	No	The skill ID.	sk-051j4pbwxzgol****
StatusFilter	string	No	The status filter. Valid values: DRAFT : Draft. UPLOADED : Published.	UPLOADED

Response elements

Element	Type	Description	Example
	object	PlainResult
RequestId	string	The request ID.	1A923337-44D9-5CAD-9A53-95084BD4****
Code	string	The status code. A value of 200 indicates success.	200
Message	string	The response message.	Success.
TotalCount	string	The total number of entries.	10
SkillInfo	array<object>	The skill information.
	array<object>	The skill information.
SkillId	string	The skill ID.	s-04zzrgosj6xd1****
SkillName	string	The skill name.	weather
Type	string	The skill type.	System
Status	string	The skill status.	active
Description	string	The skill description.	Current weather and forecasts with wttr.in via curl for locations, rain, temperature, travel planning.
Instruction	string	The skill summary.	Current weather and forecasts.
IconOssUrl	string	The OSS download URL of the skill icon.	aHR0cDovL2Nsb3VkLXBob25lLWFpLXRlc3QwLm9zcy1jbi1oYW5nemhv****
CreateTime	string	The creation time. The time is in the YYYY-MM-DD HH:mm:ss format.	2026-03-13 15:40:51
Version	string	The skill version number.	1.0.0
Category	string	The skill category.	System
SkillStatus	string	The lifecycle status of the skill.	UPLOADED
SkillSource	string	The skill source. Valid values: CONVERSATION_CREATED : Created from a conversation. USER_UPLOAD : Created by uploading a skill ZIP package.	USER_UPLOAD
SourceInstanceId	string	The source node ID of the skill created from a conversation. This parameter is empty if the skill is uploaded by a user.	acp-bp4du4v74mc7qw8****
InstalledCount	integer	The number of instances on which the skill is installed.	10
InstalledInstances	array<object>	The information about the instances on which the skill is installed.
	object	The information about the instances on which the skill is installed.
InstanceId	string	The cloud phone instance ID.	acp-6g3nocu5y9vaf****
InstallStatus	string	The installation status.	INSTALLED

Examples

Success response

JSON format

{
  "RequestId": "1A923337-44D9-5CAD-9A53-95084BD4****",
  "Code": "200",
  "Message": "Success.",
  "TotalCount": "10",
  "SkillInfo": [
    {
      "SkillId": "s-04zzrgosj6xd1****",
      "SkillName": "weather",
      "Type": "System",
      "Status": "active",
      "Description": "Current weather and forecasts with wttr.in via curl for locations, rain, temperature, travel planning.",
      "Instruction": "Current weather and forecasts.",
      "IconOssUrl": "aHR0cDovL2Nsb3VkLXBob25lLWFpLXRlc3QwLm9zcy1jbi1oYW5nemhv****",
      "CreateTime": "2026-03-13 15:40:51",
      "Version": "1.0.0",
      "Category": "System",
      "SkillStatus": "UPLOADED",
      "SkillSource": "USER_UPLOAD",
      "SourceInstanceId": "acp-bp4du4v74mc7qw8****",
      "InstalledCount": 10,
      "InstalledInstances": [
        {
          "InstanceId": "acp-6g3nocu5y9vaf****",
          "InstallStatus": "INSTALLED"
        }
      ]
    }
  ]
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.