Workspace icon

Workspace

Get and change data from Workspace API

Overview

The node interacts with the Workspace API to retrieve and manipulate data related to various resources, including meetings. Specifically, for the "Meeting" resource with the "Get Many" operation, it fetches multiple meeting records from the Workspace system. This is useful in scenarios where you want to list or process batches of meetings, such as generating reports, syncing meetings with other systems, or displaying upcoming meetings in a dashboard.

Practical examples:

  • Fetching all meetings scheduled for a particular project or team.
  • Paginating through meetings to display them in a user interface.
  • Exporting meeting data for analytics or archival purposes.

Properties

Name Meaning
Page The page number to fetch (pagination control). Default is 1.
Results Per Page Number of meetings to fetch per page. Default is 10.

These properties allow controlling pagination when retrieving many meetings, enabling efficient data handling especially when dealing with large datasets.

Output

The output contains a JSON field with an array of meeting objects fetched from the Workspace API. Each object represents a meeting with its associated details (such as title, date, participants, etc., though exact fields depend on the API response schema).

If the node supports binary data output (not explicitly shown here), it would typically represent attachments or files related to meetings, but this is not indicated in the provided code snippet.

Dependencies

  • Requires an API key credential and tenant identifier configured in n8n credentials to authenticate requests against the Workspace API.
  • The base URL for the Workspace API must be set in the node credentials.
  • The node sends HTTP requests with headers including Accept: application/json, Content-Type: application/json, and authentication headers.

Troubleshooting

  • Common issues:

    • Invalid or missing API key or tenant information will cause authentication failures.
    • Incorrect page numbers or results per page values might result in empty responses or errors.
    • Network connectivity issues can prevent successful API calls.
  • Error messages:

    • Authentication errors usually indicate invalid credentials; verify API key and tenant settings.
    • Pagination errors may occur if page or results per page are out of range; adjust these parameters accordingly.
    • API rate limits or quota exceeded errors require checking Workspace API usage policies.

Links and References

  • Refer to the official Workspace API documentation for detailed information on meeting endpoints and pagination.
  • n8n documentation on setting up API credentials and using HTTP request nodes for custom integrations.

Discussion