Basecamp

Interact with Basecamp API

Actions76

Campfire Actions
- Create a Campfire Line
- Delete a Campfire Line
- Get a Campfire
- Get a Campfire Line
- Get Campfire Lines
- Get Campfires
Card Table Actions
- Create a Card
- Create a Column
- Get a Card
- Get a Card Table
- Get a Column
- Get Cards in a Column
- Move a Card
- Move a Column
- Update a Card
- Update a Column
Chatbot Actions
- Create a Chatbot
- Create a Chatbot Line
- Delete a Chatbot
- Get a Chatbot
- Get All Chatbots
- Update a Chatbot
Client Approval Actions
- Get a Client Approval
- Get Client Approvals
Client Correspondence Actions
- Get a Client Correspondence
- Get Client Correspondences
Client Reply Actions
- Get Client Replies
- Get a Client Reply
Client Visibility Actions
- Toggle Client Visibility
Comment Actions
- Get Comments
- Create a Comment
- Get a Comment
- Update a Comment
Document Actions
- Get Documents
- Create a Document
- Get a Document
- Update a Document
Event Actions
- Get Events
Forward Actions
- Get Forwards
- Get a Forward
Inbox Actions
- Get Inbox
Inbox Reply Actions
- Get Inbox Replies
- Get an Inbox Reply
Lineup Marker Actions
- Create a Marker
- Update a Marker
- Delete a Marker
Message Actions
- Get Messages
- Create a Message
- Get a Message
- Update a Message
Message Board Actions
- Get Message Board
Message Type Actions
- Create a Message Type
- Destroy a Message Type
- Get a Message Type
- Get Message Types
- Update a Message Type
Person Actions
- Get a Person
- Get My Profile
- Get People
- Get People on a Project
- Manage People on a Project
Project Actions
- Create a Project
- Get a Project
- Get Projects
- Trash a Project
- Update a Project
Question Actions
- Get Questions
- Create a Question
- Get a Question
- Update a Question
Question Answer Actions
- Get Question Answers
- Get a Question Answer
Questionnaire Actions
- Get Questionnaire
Recording Actions
- Get Recordings
- Trash a Recording
- Archive a Recording

Overview

This node allows updating an existing document within a specified project in Basecamp. It is useful when you need to modify the title or content of a document that already exists in a Basecamp project. Common scenarios include correcting information, adding new details, or revising documents collaboratively managed in Basecamp.

For example, if you have a project with documentation stored as Basecamp documents, this node can programmatically update those documents' titles and HTML content without manual intervention through the Basecamp UI.

Properties

Name	Meaning
Project ID	The numeric ID of the project (bucket) where the document resides. Used in API path.
documentId	The numeric ID of the document to update. Used in API path.
Title	The new title for the document.
Content	The new content of the document, which may contain HTML markup.
Return Full Response	Boolean flag indicating whether to return the full HTTP response (status, headers, body) or just the response body.

Output

The node outputs JSON data representing the updated document as returned by the Basecamp API. If "Return Full Response" is enabled, the output includes the entire HTTP response object containing status code, headers, and body; otherwise, only the response body (the updated document data) is returned.

No binary data output is involved in this operation.

Dependencies

Requires an active connection to the Basecamp API using OAuth2 authentication.
The node expects the user to provide valid project and document IDs.
Proper API permissions are necessary to update documents within the specified project.

Troubleshooting

Invalid Project or Document ID: Errors may occur if the provided project or document ID does not exist or the authenticated user lacks access. Verify IDs and permissions.
Authentication Errors: Ensure the OAuth2 credentials are correctly configured and have not expired.
Content Validation: Since content supports HTML, malformed HTML might cause unexpected results. Validate HTML content before sending.
API Rate Limits: Frequent updates may hit Basecamp API rate limits; handle such errors by implementing retries or backoff strategies.

Common error messages:

404 Not Found: The specified project or document ID does not exist.
401 Unauthorized: Authentication failed; check API credentials.
400 Bad Request: Invalid input data, e.g., missing required fields like title or content.