Overview
This node integrates with the ContentStudio API to manage 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 available workspaces for an organization or user.
- Automating workspace management workflows by listing and processing workspace data.
- Integrating workspace information into broader content marketing or social media automation pipelines.
For example, a user might use this node to retrieve all their workspaces and then iterate over them to gather associated social accounts or scheduled 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 workspaces. Each item in the output corresponds to one workspace as 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 makes HTTP GET requests to the ContentStudio API base URL to fetch workspace data.
- Network connectivity to the ContentStudio API endpoint is necessary.
- No additional environment variables or external services are required beyond the API key.
Troubleshooting
Empty or missing workspace list:
Ensure the API key used has sufficient permissions to access workspace data. Also verify that the account actually has workspaces created.Invalid API key errors:
Use the "Auth - Validate Key" operation to confirm the API key validity. If invalid, update the credentials.Pagination issues (e.g., no results on higher pages):
Confirm thePageandPer Pagevalues are within valid ranges and that there are enough workspaces to fill those pages.Timeouts or network errors:
Check network connectivity and API availability. The request timeout is set to 60 seconds.
Links and References
- ContentStudio API Documentation (general reference for endpoints and data structures)
- ContentStudio Official Website
Note: This summary is based solely on static analysis of the provided source code and property definitions.