Stack Tags
Stack tags are key-value metadata attached to Pulumi stacks. They can be used for organization, filtering, and to store additional information about your stacks.
Tag Operations
The API provides endpoints for the following operations:
- Getting all tags for a stack
- Setting a specific tag value
- Deleting tags from a stack
Get Stack Tags
Use Get Stack to retrieve a stack’s details including its tags.
Set Stack Tag
POST /api/stacks/{organization}/{project}/{stack}/tags
Parameters
| Parameter | Type | In | Description |
|---|---|---|---|
organization | string | path | organization name |
project | string | path | project name |
stack | string | path | stack name |
name | string | body | tag name |
value | string | body | tag value |
Example
curl \
-H "Accept: application/vnd.pulumi+8" \
-H "Content-Type: application/json" \
-H "Authorization: token $PULUMI_ACCESS_TOKEN" \
--request POST \
--data '{"name":"{tagName}","value":"{tagValue}"}' \
https://api.pulumi.com/api/stacks/{organization}/{project}/{stack}/tags
Default response
Status: 204 OK
EMPTY RESPONSE BODY
Delete Stack Tag
DELETE /api/stacks/{organization}/{project}/{stack}/tags/{tagName}
Parameters
| Parameter | Type | In | Description |
|---|---|---|---|
organization | string | path | organization name |
project | string | path | project name |
stack | string | path | stack name |
tagName | string | path | tag name |
Example
curl \
-H "Accept: application/vnd.pulumi+8" \
-H "Content-Type: application/json" \
-H "Authorization: token $PULUMI_ACCESS_TOKEN" \
--request DELETE \
https://api.pulumi.com/api/stacks/{organization}/{project}/{stack}/tags/{tagName}
Default response
Status: 204 OK
EMPTY RESPONSE BODY
Thank you for your feedback!
If you have a question about how to use Pulumi, reach out in Community Slack.
Open an issue on GitHub to report a problem or suggest an improvement.
