Nestr icon

Nestr

Manage projects, roles, circles, and workspaces in Nestr - Role-based and self-organized collaboration
Join our community

Actions29

Overview

This node integrates with the Nestr platform to manage posts within workspaces. Specifically, the Post: Create operation allows users to create new posts inside a selected workspace. This is useful for teams collaborating on projects who want to programmatically add posts such as updates, announcements, or discussions directly into their Nestr workspace.

Practical examples include:

  • Automatically creating a post when a new task is assigned in a project management workflow.
  • Posting status updates from external monitoring tools into a Nestr workspace.
  • Logging important events or notes related to a workspace automatically.

Properties

Name Meaning
Workspace Name or ID Select the workspace where the post will be created. Choose from a list or specify an ID via expression.
Additional Fields Optional extra fields to customize the post:
  Labels Comma-separated list of labels to tag the post (e.g., "urgent,announcement").
  Parent ID ID of a parent item to nest this post under (for hierarchical organization).

Output

The node outputs JSON data representing the newly created post object returned by the Nestr API. This typically includes details such as the post's unique ID, title, description, associated workspace ID, labels, and any parent-child relationships.

No binary data output is produced by this operation.

Dependencies

  • Requires an active connection to the Nestr API using OAuth2 authentication.
  • The node depends on the nestrApiRequest helper function to communicate with the Nestr REST API.
  • The user must have appropriate permissions in the target workspace to create posts.
  • The workspace list is dynamically loaded via the getWorkspaces method, which fetches available workspaces from the API.

Troubleshooting

  • Common issues:

    • Invalid or missing workspace ID: Ensure the workspace exists and the ID is correct.
    • Insufficient permissions: Verify that the API credentials have rights to create posts in the workspace.
    • Incorrect label formatting: Labels should be comma-separated strings without extra spaces.
    • Parent ID does not exist or is invalid: Confirm the parent item ID is valid within the workspace.

  • Error messages:

    • API errors will typically return messages indicating the cause, such as "Workspace not found" or "Unauthorized".
    • Network or authentication failures may result in timeout or 401 Unauthorized errors.

  • Resolutions:

    • Double-check all input parameters, especially workspace ID and additional fields.
    • Refresh or reconfigure API credentials if authentication fails.
    • Use expressions carefully to ensure dynamic values resolve correctly.

Links and References

Discussion