Outline icon

Outline

Interact with Outline knowledge base

Overview

This node interacts with the Outline knowledge base API, allowing users to manage various resources such as collections, documents, attachments, groups, comments, and more. Specifically, for the Collection - Delete operation, it deletes a specified collection from the Outline knowledge base.

This operation is useful when you want to programmatically remove an entire collection of documents and related data from your knowledge base, for example:

  • Cleaning up outdated or irrelevant collections.
  • Automating maintenance tasks in your knowledge base.
  • Managing collections dynamically based on external triggers or workflows.

Properties

Name Meaning
Collection ID The unique identifier of the collection to delete. This is required to specify which collection should be removed.

Output

The output JSON contains the response from the Outline API after attempting to delete the collection. Typically, this will include confirmation of deletion or relevant status information returned by the API.

If the deletion is successful, the output confirms the removal of the collection. If there is an error (e.g., invalid ID, permission issues), the output will contain an error message describing the problem.

No binary data is involved in this operation.

Dependencies

  • Requires an API key credential for authenticating requests to the Outline knowledge base API.
  • The node uses the Outline API endpoints internally via POST requests to perform actions.
  • Proper configuration of the API authentication credential in n8n is necessary.

Troubleshooting

  • Common Issues:

    • Invalid or missing Collection ID: Ensure the Collection ID provided is correct and exists.
    • Insufficient permissions: The API key used must have rights to delete collections.
    • Network or API errors: Check connectivity and API service status.
  • Error Messages:

    • "error": "Collection not found": The specified Collection ID does not exist.
    • "error": "Unauthorized": Authentication failed; verify API credentials.
    • Other API error messages will be passed through in the output JSON.
  • Resolution:

    • Double-check the Collection ID input.
    • Verify that the API key has appropriate permissions.
    • Review network settings and retry if transient errors occur.

Links and References

Discussion