Setting up your vendor project

Your vendor project is used for product onboarding, access management, and API access. As soon as the vendor integration has been successfully completed, this project must not be deleted. To prevent accidental project deletion, you can apply the delete-protected and read-only labels to the project, as described below.

1 Create a new project

To distinguish vendor projects from projects used for testing and verifications, we recommend applying a consistent project naming pattern, e. g. [product-name]-prod and [product-name]-test.

For instructions on how to create a project see: Create a Project

2 Project status

Fetch the current project state with the following API call, where projectID is the ID of your vendor project and accessToken is the access token for the service account.

To retreive the access token, refer to the tutorial Aquire access token.

curl --location --request GET 'https://resource-manager.api.stackit.cloud/v2/projects/[Insert your projectId here]' \
--header 'Authorization: Bearer [Insert your short-lived or long-lived token here]'

The response payload contains all associated project labels.

{
  "name": "ANONYMIZED",
  "parent": {
    "id": "ANONYMIZED",
    "containerId": "ANONYMIZED",
    "type": "FOLDER"
  },
  "containerId": "ANONYMIZED",
  "projectId": "ANONYMIZED",
  "lifecycleState": "ACTIVE",
  "creationTime": "2025-08-26T07:27:14.071614Z",
  "updateTime": "2025-08-26T07:27:36.139341Z",
  "labels": {
    "scope": "PUBLIC",
    "billingReference": "ANONYMIZED"
  }
}

3 Set labels

Set the labels delete-protected and read-only with the following API call:

curl --location --request PATCH 'https://resource-manager.api.stackit.cloud/v2/projects/[projectId]'
--header 'Content-Type: application/json'
--header 'Authorization: Bearer [accessToken]'
--data '{ "labels": { "delete-protected": "true", "read-only": "true" } }'

Now you can continue with the integration of the product itself.

If it should become necessary to delete a vendor project, please open a Support ticket, or contact the STACKIT Marketplace directly for assistance: marketplace@stackit.cloud.