Updated on 2025-11-28 GMT+08:00

Creating an Application

Function

An application is a service system with complete functions and consists of one or more components related to features.

This API is used to create an application.

Debugging

You can debug this API in API Explorer which supports automatic authentication. API Explorer automatically generates sample SDK code and provides the debug function.

URI

POST /v2/{project_id}/cas/applications

Table 1 Path parameters

Parameter

Mandatory

Type

Description

project_id

Yes

String

Tenant's project ID. See Obtaining a Project ID.

Request

Table 2 Request header parameters

Parameter

Mandatory

Type

Description

Content-Type

Yes

String

Message body type (format). Default value: application/json;charset=utf8.

X-Auth-Token

Yes

String

API calling can be authenticated using a token or AK/SK. If you use a token, this parameter is mandatory and must be set to the token. For details about how to obtain a token, see Obtaining a User Token.

Table 3 Request body parameters

Parameter

Mandatory

Type

Description

name

Yes

String

Application name.

The value contains 2 to 64 characters consisting of letters, digits, hyphens (-), and underscores (_). It starts with a letter and ends with a letter or digit.

description

No

String

Application description.

The value can contain up to 128 characters.

enterprise_project_id

No

String

Enterprise project ID.

Response

Table 4 Response parameters

Parameter

Type

Description

id

String

Application ID.

name

String

Application name.

description

String

Application description.

creator

String

Creator.

project_id

String

Project ID.

enterprise_project_id

String

Enterprise project ID.

create_time

Integer

Creation time.

update_time

Integer

Update time.

unified_model

String

Whether to enable the unified model. Default value: null.

Example Request

Create application app-xpmtii and add application description test.

{
	"name": "app-xpmtii",
	"description": "test"
}

Example Response

{
	"id": "e5213b62-0e3c-476f-9960-3e4108787350",
	"name": "app-xpmtii",
	"description": "test",
	"project_id": "e7d2e9c589e5445e808a8ff0d1235aca",
	"enterprise_project_id": "0",
	"creator": "ss-test",
	"create_time": 1610432385245,
	"update_time": 1610432385245,
	"unified_model": null
}

Status Code

Status Code

Description

200

OK

400

Bad Request

404

Not Found

500

Internal Server Error

Error Code

See ServiceStage Error Codes.