When invoking Alibaba Cloud Bailian applications via API, you must provide the APP ID and Workspace ID to specify the target application and its associated workspace.
When invoking Alibaba Cloud Bailian applications (e.g., agent applications or workflow applications) via API, authentication credentials are required to identify both the target application and its associated workspace:
The unique
The
Use this method to quickly locate the ID of the workspace currently logged into and actively used.
Use this method when you need to query or manage all workspaces under the primary account. This operation is restricted to primary account administrators only.
After obtaining the required credentials, refer to the DashScope API Agent Applications or Responses API documentation to construct and send your API requests.
Q: Why does a RAM sub-account receive an error when accessing the “Workspace Management” page?
A: Only the primary account administrator—or a RAM sub-account explicitly assigned administrator privileges—can access this page.
- If the application resides in the default workspace, only the APP ID is required.
- If the application resides in a sub-workspace, both the APP ID and Workspace ID must be provided.
Currently, APP ID and Workspace ID can only be retrieved manually from the console; they cannot be queried via API or CLI tools.
Obtain APP ID
The unique APP ID is required for all API invocations of any application.
1
Access the Application Management Console
Navigate to the Application Management page.
2
Copy the APP ID
Locate your target application in the application list and copy its
APP ID.Obtain Workspace ID
The Workspace ID uniquely identifies a workspace. It is mandatory in API requests only when:
- Invoking an application deployed in a sub-workspace, or
- Invoking models in the Germany (Frankfurt), China North 2 (Beijing), Singapore, or Japan (Tokyo) regions.
Retrieve the Current Workspace ID
Use this method to quickly locate the ID of the workspace currently logged into and actively used.
1
Access the Console
Go to the Alibaba Cloud Bailian Console homepage and select your target region.
2
View Workspace ID
Click the Settings icon (⚙️) in the top-right corner of the page. The workspace ID will appear in the pop-up dialog — copy it as needed.
RAM sub-accounts can only view the IDs of workspaces they have been explicitly added to.
List All Workspace IDs
Use this method when you need to query or manage all workspaces under the primary account. This operation is restricted to primary account administrators only.
1
Log in to the Console
Log in to the Alibaba Cloud Bailian Console using either the primary account or an authorized RAM sub-account.
2
Navigate to Workspace Management
Click the Settings icon (⚙️) in the top-right corner and go to the Workspace Management page.
3
Copy Workspace ID
In the Workspace ID column, locate the desired workspace and copy its ID.
Next Steps
After obtaining the required credentials, refer to the DashScope API Agent Applications or Responses API documentation to construct and send your API requests.
Frequently Asked Questions
Q: Why does a RAM sub-account receive an error when accessing the “Workspace Management” page?A: Only the primary account administrator—or a RAM sub-account explicitly assigned administrator privileges—can access this page.