Actions18
- Attachment Actions
- Comment Actions
- Dartboard Actions
- Doc Actions
- Folder Actions
- Help Center Article Actions
- Skill Actions
- Task Actions
- View Actions
Overview
This node integrates with the Dart project management service, allowing users to update documents ("Docs") within their projects. The "Update Doc" operation specifically lets users modify an existing document by specifying its unique ID and providing the updated content in JSON format. This is useful for automating updates to project documentation or syncing external data sources with Dart Docs.
Practical examples include:
- Automatically updating project specs stored as Dart Docs when changes occur in a source system.
- Syncing task-related notes or reports into Dart Docs as part of a workflow.
- Programmatically revising documentation based on user input or other automated triggers.
Properties
| Name | Meaning |
|---|---|
| ID | The unique identifier of the Doc to update. This is required to specify which document will be modified. |
| Item | The new content for the Doc, provided as a JSON object. This represents the updated data that will replace or augment the existing document content. |
Output
The node outputs the response from the Dart API after attempting to update the specified Doc. The output is structured as JSON and typically contains details about the updated document, such as its ID, updated fields, timestamps, or status messages confirming the update.
If the node supports binary data (not indicated here), it would represent attachments or file contents related to the Doc, but this implementation focuses on JSON data.
Dependencies
- Requires an API key credential for authenticating with the Dart service.
- Needs the Dart API base URL configured in credentials.
- The node sends HTTP requests with JSON payloads to the Dart API endpoint.
Troubleshooting
- Invalid ID error: If the provided Doc ID does not exist or is malformed, the API will return an error. Verify the ID is correct and corresponds to an existing document.
- Authentication failures: Ensure the API key credential is valid and has sufficient permissions to update Docs.
- Malformed JSON in Item: The "Item" property must be valid JSON. Invalid JSON syntax will cause request failures.
- Network issues: Connectivity problems or incorrect base URL configuration can prevent successful API calls.
Links and References
- Dart official API documentation (for detailed API endpoints and data schemas)
- n8n documentation on creating and using credentials
- JSON formatting guides for preparing the "Item" property content