Blue icon

Blue

Interact with Blue Project Management via GraphQL API

Actions10

Tag Record

AI-generated

Overview

This node operation tags a specific record within a project in the Blue Project Management system. It allows users to add one or more tags to a record by specifying the company, project, record ID, and the tags to be added. This is useful for categorizing or labeling records for better organization and filtering within project management workflows.

Use Case Examples

  1. Tagging a task record with priority or status tags to facilitate tracking and reporting.
  2. Adding multiple tags to a customer record to indicate different attributes or stages in a sales pipeline.

Properties

Name Meaning
Company The company containing the records/projects to work with. This is required to identify the scope of the operation.
Project The project within the company to work with. Required for tagging records to specify the project context. Optional for some operations but required here.
Tag Names or IDs The tags to add to the record. Users can select from a list of tags or specify tag IDs using expressions. This is required to define which tags to apply.
Record ID The ID of the record to tag. This is required to identify the specific record to update.
Additional Options Optional settings such as request timeout and whether to return the full GraphQL response including errors and extensions.

Output

JSON

  • json - The JSON response data from the tagging operation, containing success status and any returned data or errors.

Dependencies

  • Requires an API key credential for Blue Project Management API authentication.

Troubleshooting

  • Common issues include invalid or missing company, project, record, or tag IDs which will cause errors from the API.
  • GraphQL errors returned by the API will be included in the error messages; ensure the IDs and tags exist and are accessible.
  • Timeouts can occur if the request takes too long; adjust the timeout option if needed.
  • If the node fails and 'Continue On Fail' is not enabled, the workflow will stop execution on error.

Links

  • Blue Node Documentation - Official documentation for the Blue node in n8n, including setup and usage instructions.

Discussion