Documentation

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_id or project_tag_ids is required.

Response

Success Response (200 OK)

Success returns the API envelope without data.

Error Responses

  • 400 Bad Request: Invalid request
  • 422 Unprocessable Entity: Request fields fail schema validation
  • 401 Unauthorized: Authentication failed
  • 403 Forbidden: User does not have permission to link or unlink tags for this project

See the Projects API overview for related endpoints.