Actions21
Overview
This node interacts with the GravitySocial API to manage media files within a specified workspace. The Media: Update operation allows users to update metadata of an existing media file, specifically its alternative text (alt text). This is useful for improving accessibility and SEO by providing descriptive text for images or other media assets.
Typical use cases include:
- Updating alt text for images after uploading them.
- Correcting or enhancing descriptions of media files in bulk workflows.
- Automating media metadata management as part of content publishing pipelines.
Properties
| Name | Meaning |
|---|---|
| Workspace UUID | The unique identifier (UUID) of the workspace where the media file resides. |
| Media UUID | The unique identifier (UUID) of the media file to update. |
| Update Fields | Collection of fields to update on the media file. Currently supports: |
| Alt Text | Alternative text description for the media file, used for accessibility and SEO. |
Output
The node outputs the JSON response returned by the GravitySocial API after updating the media file. This typically includes the updated media object with its properties such as UUID, URLs, alt text, and other metadata.
If multiple items are processed, the output is an array of these updated media objects.
The node does not output binary data for this operation.
Dependencies
- Requires an active connection to the GravitySocial API via an API key credential.
- The node expects the API base URL and access token to be configured in the credentials.
- The workspace UUID must be provided to scope the request correctly.
- The node uses HTTP requests with Bearer token authorization.
Troubleshooting
- Missing or invalid Workspace UUID or Media UUID: The API will reject requests without valid identifiers. Ensure these are correctly set.
- Validation errors: If the alt text or other fields do not meet API requirements, the node may throw validation errors with details. Review error messages for specific field issues.
- API authentication failures: Check that the API key credential is valid and has necessary permissions.
- Network or connectivity issues: Verify network access to the GravitySocial API endpoint.
- Unsupported file or missing attributes: Not applicable for update operation but relevant for upload operations.
Common error message example:
Validation Error: The given data was invalid. - alt_text: Must be a string with max length 255.
Resolution: Adjust the alt text value accordingly.
Links and References
- GravitySocial API Documentation (hypothetical link as no direct link provided)
- n8n HTTP Request Node documentation: https://docs.n8n.io/nodes/n8n-nodes-base.httpRequest/
- Best practices for alt text: https://webaim.org/techniques/alttext/