Outline icon

Outline

Interact with Outline knowledge base

Overview

This node interacts with the Outline knowledge base system, specifically providing functionality to list audit trail events. The "Event" resource with the "List" operation allows users to retrieve a paginated list of events that represent the audit trail within the Outline system.

Common scenarios where this node is beneficial include:

  • Monitoring changes and activities in the knowledge base for compliance or auditing purposes.
  • Tracking user actions or system events over time.
  • Integrating event logs into external monitoring or reporting tools.

For example, an organization might use this node to regularly fetch recent audit events to analyze who accessed or modified documents, helping maintain security and transparency.

Properties

Name Meaning
Additional Fields A collection of optional parameters to refine the event listing:
- Date Filter: Filter events by date range (Day, Week, Month, Year)
- Include Archived: Not applicable here (property exists but not used for events)
- Include Drafts: Not applicable here
- Limit: Number of results to return (1 to 100, default 25)
- Offset: Number of results to skip (default 0)
- Sort: Not applicable here (property exists but not used for events)
- Direction: Not applicable here
- Status Filter: Not applicable here

Note: For the Event List operation, only limit and offset from the additional fields are actually used to control pagination.

Output

The output is a JSON array containing event objects representing audit trail entries. Each event object includes details about a specific action or change recorded in the Outline system.

The exact structure of each event object depends on the Outline API response but typically includes information such as:

  • Event ID
  • Timestamp
  • Event type or action performed
  • User or actor responsible
  • Related document or resource identifiers
  • Additional metadata describing the event context

No binary data output is produced by this operation.

Dependencies

  • Requires an API key credential for authenticating with the Outline knowledge base API.
  • The node makes HTTP POST requests to the /events.list endpoint of the Outline API.
  • No additional environment variables or configurations beyond the API credential are required.

Troubleshooting

  • Common issues:

    • Authentication failures due to invalid or missing API credentials.
    • Exceeding rate limits imposed by the Outline API.
    • Providing invalid values for pagination parameters (limit and offset).
  • Error messages:

    • Errors returned from the Outline API will be passed through, often indicating issues like unauthorized access or bad request parameters.
    • If the node is set to continue on fail, errors will appear in the output JSON under an error field.
  • Resolutions:

    • Verify that the API key credential is correctly configured and has sufficient permissions.
    • Adjust pagination parameters to valid ranges.
    • Check network connectivity and API availability.

Links and References

Discussion