Overview
This node integrates with the ContentStudio API to manage various resources such as workspaces, social accounts, and posts. Specifically, for the Workspace - List operation, it retrieves a paginated list of workspaces accessible via the authenticated API key.
Common scenarios where this node is beneficial include:
- Fetching all workspaces associated with a ContentStudio account for reporting or synchronization.
- Automating workspace management workflows by listing available workspaces before performing further actions.
- Integrating workspace data into other systems or dashboards.
Example: You want to retrieve the first 10 workspaces to display in a dashboard or to select one for subsequent operations like managing social accounts or posts.
Properties
| Name | Meaning |
|---|---|
| Page | The page number of results to retrieve (minimum 1). Used for pagination. |
| Per Page | Number of workspaces to return per page (minimum 1, maximum 100). Controls page size. |
Output
The node outputs an array of JSON objects representing the retrieved workspaces. Each item corresponds to a workspace object returned by the ContentStudio API's /v1/workspaces endpoint.
The exact structure of each workspace object depends on the API response but typically includes identifiers, names, and metadata about each workspace.
No binary data output is produced by this operation.
Dependencies
- Requires an API key credential for authenticating requests to the ContentStudio API.
- The node expects the base URL of the ContentStudio API to be provided in the credentials.
- Network connectivity to the ContentStudio API endpoint is necessary.
Troubleshooting
- Empty or missing workspace list: Ensure the API key has sufficient permissions and that there are existing workspaces in the ContentStudio account.
- API request timeout or failure: Check network connectivity and verify the base URL and API key are correctly configured.
- Invalid pagination parameters: The
Pagemust be ≥ 1, andPer Pagemust be between 1 and 100; otherwise, the API may reject the request. - Unexpected API errors: Review the error message returned by the API for details. Common issues include invalid API keys or rate limiting.
Links and References
- ContentStudio API Documentation (general reference for endpoints and data structures)
- n8n documentation on Creating Custom Nodes