Actions119
- Campfire Actions
- Card Table Actions
- Chatbot Actions
- Client Approval Actions
- Client Correspondence Actions
- Client Reply Actions
- Client Visibility Actions
- Comment Actions
- Document Actions
- Event Actions
- Forward Actions
- Inbox Actions
- Inbox Reply Actions
- Lineup Marker Actions
- Message Actions
- Message Board Actions
- Message Type Actions
- Person Actions
- Project Actions
- Question Actions
- Question Answer Actions
- Questionnaire Actions
- Recording Actions
- Schedule Actions
- Schedule Entry Actions
- Template Actions
- Todo Actions
- Todolist Actions
- Todolist Group Actions
- Todoset Actions
- Upload Actions
- Vault Actions
- Webhook Actions
Overview
The "Get a Vault" operation in the Vault resource of this Basecamp node retrieves detailed information about a specific vault within a project (referred to as a bucket). This operation is useful when you need to access or verify the contents and metadata of a particular vault, such as for auditing, reporting, or integration purposes.
Practical scenarios include:
- Fetching vault details to display in a dashboard.
- Integrating vault data into other systems for backup or analysis.
- Validating vault existence and properties before performing further actions.
Properties
| Name | Meaning |
|---|---|
| Project ID | The numeric ID of the project (bucket) that contains the vault. Used in the API endpoint path. |
| Vault ID | The numeric ID of the vault to retrieve. Used in the API endpoint path. |
| Return Full Response | Boolean flag indicating whether to return the full HTTP response (status code, headers, body) or just the response body. |
Output
The output JSON contains the details of the requested vault. This typically includes all metadata and properties associated with the vault as returned by the Basecamp API.
If the "Return Full Response" property is set to true, the output will include the entire HTTP response object, which contains:
- Status code
- Headers
- Body (the vault data)
Otherwise, only the vault data (response body) is returned.
This node does not output binary data.
Dependencies
- Requires an API authentication token configured via OAuth2 credentials for Basecamp.
- The node uses the Basecamp API endpoint constructed with the account ID from credentials.
- No additional external dependencies are required.
Troubleshooting
- Invalid Project ID or Vault ID: If either ID is incorrect or does not exist, the API will likely return a 404 error. Verify IDs before running the node.
- Authentication Errors: Ensure the OAuth2 credentials are valid and have sufficient permissions to access the vault.
- Network Issues: Connectivity problems can cause request failures; check network settings and Basecamp service status.
- Return Full Response Misuse: Setting "Return Full Response" to true changes the output format; downstream nodes expecting only the body may fail. Adjust subsequent processing accordingly.