Workboard - SJI icon

Workboard - SJI

Interact with Workboard API

Activity → Create

AI-generated

Overview

This node interacts with the Workboard API to create a new activity within the Workboard system. It allows users to specify various details about the activity such as description, notes, owner, workstream, team, due date, state, priority, rating, effort, tags, and comments. The node is useful for automating the creation of activities in project management or team collaboration workflows, enabling integration with other systems or automations.

Use Case Examples

  1. Creating a new activity with a detailed description and notes for a project management workflow.
  2. Automatically adding activities to a workstream based on external triggers or events.
  3. Setting activity priority and due dates dynamically from other data sources.

Properties

Name Meaning
Additional Fields A collection of optional fields to specify details about the activity, including description, note, text format, owner, workstream, team, due date, state, priority, rating, effort, tags, and comments.

Output

JSON

  • ai_description - Formatted description of the created activity.
  • ai_note - Formatted note of the created activity.
  • ai_owner - Owner of the created activity.
  • ai_workstream - Workstream associated with the created activity.
  • ai_team - Team associated with the created activity.
  • ai_due_date - Due date of the created activity.
  • ai_state - State of the created activity.
  • ai_priority - Priority of the created activity.
  • ai_rating - Rating of the created activity.
  • ai_effort - Effort estimation of the created activity.
  • ai_tags - Tags associated with the created activity.
  • ai_comments - Comments associated with the created activity.

Dependencies

  • Workboard API

Troubleshooting

  • Ensure the API authentication token (bearer token) is correctly configured in the node credentials to avoid authorization errors.
  • Verify that the Workboard API base URL is correct and accessible from the environment where the node runs.
  • Check the formatting of JSON fields such as tags and comments to ensure they are valid JSON arrays.
  • If the node fails with an error, enable 'Continue On Fail' to handle errors gracefully and inspect error messages for troubleshooting.

Links

  • Workboard API Documentation - Official API documentation for Workboard, useful for understanding available endpoints and data formats.

Discussion