Document creating a dock tool by type#413
Conversation
Creating a tool now takes a required tool_type (one of Message::Board, Todoset, Vault, Schedule, Chat::Transcript, Kanban::Board, Questionnaire, or Inbox) plus an optional title, and returns 201 Created with the same body as Get a tool. When title is omitted, Basecamp chooses it.
There was a problem hiding this comment.
Pull request overview
Updates the Basecamp API documentation for creating dock tools so it reflects the current “create by type” behavior (via tool_type) rather than cloning an existing tool.
Changes:
- Rewrites the “Create a tool” endpoint description to describe adding a tool by
tool_type. - Updates request parameter documentation (required
tool_type, optionaltitle). - Updates JSON and cURL examples to send
tool_typeinstead ofsource_recording_id.
Tip
If you aren't ready for review, convert to a draft PR.
Click "Convert to draft" or run gh pr ready --undo.
Click "Ready for review" or run gh pr ready to reengage.
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
![chatgpt-codex-connector[bot]](https://avatars.githubusercontent.com/in/1144995?s=60&v=4){kind=small}
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: f366722d9f
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
Updates the Create a tool section to match the current API.
Creating a tool in a project's dock now works by type rather than by cloning an existing tool:
tool_type— the kind of tool to add. One ofMessage::Board,Todoset,Vault,Schedule,Chat::Transcript,Kanban::Board,Questionnaire, orInbox.title— the name for the tool. When omitted, Basecamp chooses the title.The endpoint returns
201 Createdwith the same JSON body as Get a tool. The JSON and cURL examples are updated to sendtool_type.