Actions10
Update Record
AI-generatedOverview
This node operation updates a record within a specified company and project in the Blue Project Management system via its GraphQL API. It allows users to modify various attributes of a record such as title, description, start and due dates, position, color, assignees, tags, and custom fields. This operation is useful for automating updates to project management records, ensuring data consistency, and integrating Blue with other systems or workflows.
Use Case Examples
- Updating a task's title and due date in a project to reflect new deadlines.
- Assigning multiple users to a record and tagging it for categorization.
- Changing the position and color of a record to prioritize and visually distinguish it in a todo list.
Properties
| Name | Meaning |
|---|---|
| Company | The company containing the records or projects to update. This is required to identify the scope of the update. |
| Project | The project within the company where the record exists. Required for most operations except optionally for getting records. |
| Todo List | Optional todo list to move the record to during update. |
| Record ID | The unique identifier of the record to update. This is required. |
| Title | Optional new title for the record. |
| Description | Optional new description or text content for the record. |
| Start Date | Optional start date for the record. |
| Due Date | Optional due date for the record. |
| Position | Optional position number to reorder the record in the list. |
| Color | Optional color code to visually distinguish the record. |
| Assignee Names or IDs | Users to assign to the record, selectable from the project user list or specified by IDs. |
| Tag Names or IDs | Tags to add to the record, selectable from the project tag list or specified by IDs. |
| Add Custom Field to Update | Custom fields to update on the record, with support for multiple field types and values. |
| Additional Options | Extra options such as request timeout and whether to return the full GraphQL response including errors and extensions. |
Output
JSON
json- The updated record data returned from the Blue API after the update operation.
Dependencies
- Blue Project Management API
- An API key credential for authentication
Troubleshooting
- Ensure the companyId, projectId, and recordId are correctly specified and exist in Blue.
- Check that the API key credential is valid and has sufficient permissions.
- If the operation fails with GraphQL errors, review the error messages for invalid field values or missing required fields.
- Timeout errors can be resolved by increasing the timeout option in additionalOptions.
Links
- Blue Project Management GraphQL API Documentation - Official API documentation for Blue Project Management, useful for understanding available queries and mutations.