Link or Unlink a Tag with a Project
POST /projects/{project_id}/tag/{action}
Links or unlinks a tag with a project. This endpoint supports site and user tags, as well as portal tags.
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
project_id |
string | Yes | Project ID where the tag will be linked or unlinked |
action |
string | Yes | Action to perform, either "link" or "unlink" |
Request Body
Supply exactly one scope (site_id, portal_id, or user_id) and one of project_tag_id or project_tag_ids.
| Field | Type | Required | Description |
|---|---|---|---|
site_id |
string | No | Site ID |
portal_id |
string | No | Portal ID |
user_id |
string | No | User ID |
project_tag_id |
string | No* | Project tag ID |
project_tag_ids |
array of strings | No* | List of project tag IDs |
* Either
project_tag_idorproject_tag_idsis required.
Response
Success Response (200 OK)
Success returns the API envelope without data.
Error Responses
400 Bad Request: Invalid request422 Unprocessable Entity: Request fields fail schema validation401 Unauthorized: Authentication failed403 Forbidden: User does not have permission to link or unlink tags for this project
See the Projects API overview for related endpoints.