DeleteVersion - Delete a version

Updated at:

Deletes a specified version from a project.

Applicable editions

Central edition, Region edition

Endpoint and authorization information

  • Get the endpoint: Replace {domain} in the API request syntax.

  • Get a personal access token.

  • Get organizationId: Required only for the Central edition. Go to the Basic Information page in the Organization Management console to obtain your organization ID.

Product

Resource

Required permission

Project Collaboration

Version

Read and write

Request syntax

Central edition

DELETE https://{domain}/oapi/v1/projex/organizations/{organizationId}/projects/{projectId}/versions/{id}

Region edition

DELETE https://{domain}/oapi/v1/projex/projects/{projectId}/versions/{id}

Request headers

Parameter

Type

Required

Description

Example value

x-yunxiao-token

string

Yes

Personal access token

pt-0fh3****0fbG_35af****0484

Request parameters

Parameter

Type

Location

Required

Description

Example value

projectId

string

path

Yes

Project ID.

id

string

path

Yes

Version ID.

organizationId

string

path

  • Yes: Central edition

  • No: Region edition

Organization ID.

-

object

body

No

Request body. Ignored when using a personal access token.

operatorId

string

body

No

User ID of the operator. Ignored when using a personal access token.

user-xxx

Request examples

Central edition

curl -X 'DELETE' \
  'https://{domain}/oapi/v1/projex/organizations/{organizationId}/projects/{projectId}/versions/{id}' \
  -H 'Content-Type: application/json' \
  -H 'x-yunxiao-token: pt-0fh3****0fbG_35af****0484' \
  --data '
    {
        "operatorId": "user-xxx"
    }'

Region edition

curl -X 'DELETE' \
  'https://{domain}/oapi/v1/projex/projects/{projectId}/versions/{id}' \
  -H 'Content-Type: application/json' \
  -H 'x-yunxiao-token: pt-0fh3****0fbG_35af****0484' \
  --data '
    {
        "operatorId": "user-xxx"
    }'

Response parameters

None

Error codes

For more information, see Error Code Center.