Skip to content

Conversation

@jeremy
Copy link
Member

@jeremy jeremy commented Jan 23, 2026

Summary

Documents newly added JSON API endpoints that enable automation via bcq/coworker.

  • Add create and update endpoints to Questions API (check-ins)
  • Add create and update endpoints to Question Answers API
  • Add complete Tools API documentation for dock management (new file)

Changes

sections/questions.md

  • POST /buckets/:bucket_id/questionnaires/:questionnaire_id/questions.json - Create a question
  • PUT /buckets/:bucket_id/questions/:question_id.json - Update a question

sections/question_answers.md

  • POST /buckets/:bucket_id/questions/:question_id/answers.json - Create an answer
  • PUT /buckets/:bucket_id/question_answers/:question_answer_id.json - Update an answer

sections/tools.md (new)

  • GET /buckets/:bucket_id/dock/tools/:tool_id.json - Get a tool
  • POST /buckets/:bucket_id/dock/tools.json - Create a tool
  • PUT /buckets/:bucket_id/dock/tools/:tool_id.json - Update a tool
  • DELETE /buckets/:bucket_id/dock/tools/:tool_id.json - Trash a tool
  • POST /buckets/:bucket_id/recordings/:recording_id/position.json - Enable a tool
  • PUT /buckets/:bucket_id/recordings/:recording_id/position.json - Reposition a tool
  • DELETE /buckets/:bucket_id/recordings/:recording_id/position.json - Disable a tool

README.md

  • Added tools.md to API endpoints list

Test plan

  • Verified against bc3 api-gaps branch (33 runs, 123 assertions, 0 failures)
  • Documentation follows existing patterns (cURL examples, JSON responses)

Add documentation for:
- POST /buckets/:id/questionnaires/:id/questions.json (create)
- PUT /buckets/:id/questions/:id.json (update)

Includes schedule configuration parameters (frequency, time_of_day, days)
and cURL examples.
Add documentation for:
- POST /buckets/:id/questions/:id/answers.json (create)
- PUT /buckets/:id/question_answers/:id.json (update)

Includes content and group_on parameters with cURL examples.
New tools.md section with full CRUD + positioning:
- GET /buckets/:id/dock/tools/:id.json (show)
- POST /buckets/:id/dock/tools.json (create by cloning)
- PUT /buckets/:id/dock/tools/:id.json (rename)
- DELETE /buckets/:id/dock/tools/:id.json (trash)
- POST /buckets/:id/recordings/:id/position.json (enable)
- PUT /buckets/:id/recordings/:id/position.json (reposition)
- DELETE /buckets/:id/recordings/:id/position.json (disable)

Adds tools.md link to README API endpoints list.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants