Basecamp icon

Basecamp

Interact with Basecamp API

Actions119

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.

Links and References

Discussion