# Basecamp

Manage Basecamp 3: projects, to-dos, messages, schedules, documents, people. Exposes **44 actions** covering the full API surface
the agent needs - read and write.

## What it can do

| Method | What it does |
| --- | --- |
| `basecamp_list_projects` | List projects - GET /projects.json. |
| `basecamp_get_project` | Get one project - GET /projects/{id}.json. |
| `basecamp_create_project` | Create a project - POST /projects.json. |
| `basecamp_update_project` | Update a project - PUT /projects/{id}.json. |
| `basecamp_archive_project` | Archive a project - PUT /projects/{id}/archive.json. |
| `basecamp_unarchive_project` | Unarchive a project - PUT /projects/{id}/unarchive.json. |
| `basecamp_list_todosets` | List to-do sets in a project - GET /projects/{project_id}/todosetsimpleLists.json. |
| `basecamp_get_todoset` | Get one to-do set - GET /projects/{project_id}/todosets/{id}.json. |
| `basecamp_create_todoset` | Create a to-do set - POST /projects/{project_id}/todosets.json. |
| `basecamp_update_todoset` | Update a to-do set - PUT /projects/{project_id}/todosets/{id}.json. |
| `basecamp_list_todolists` | List to-do lists in a to-do set - GET /projects/{project_id}/todosets/{todoset_id}/todolists.json. |
| `basecamp_get_todolist` | Get one to-do list - GET /projects/{project_id}/todolists/{id}.json. |
| `basecamp_create_todolist` | Create a to-do list - POST /projects/{project_id}/todosets/{todoset_id}/todolists.json. |
| `basecamp_update_todolist` | Update a to-do list - PUT /projects/{project_id}/todolists/{id}.json. |
| `basecamp_list_todos` | List to-dos in a to-do list - GET /projects/{project_id}/todolists/{todolist_id}/todos.json. |
| `basecamp_list_todos_assigned` | List assigned to-dos (across all projects) - GET /my/todos.json. |
| `basecamp_get_todo` | Get one to-do - GET /projects/{project_id}/todos/{id}.json. |
| `basecamp_create_todo` | Create a to-do - POST /projects/{project_id}/todolists/{todolist_id}/todos.json. |
| `basecamp_update_todo` | Update a to-do - PUT /projects/{project_id}/todos/{id}.json. |
| `basecamp_complete_todo` | Mark a to-do as completed - PUT /projects/{project_id}/todos/{id}/completion.json. |
| `basecamp_uncomplete_todo` | Mark a to-do as incomplete - DELETE /projects/{project_id}/todos/{id}/completion.json. |
| `basecamp_list_messages` | List messages in a project - GET /projects/{project_id}/messages.json. |
| `basecamp_get_message` | Get one message - GET /projects/{project_id}/messages/{id}.json. |
| `basecamp_create_message` | Create a message (discussion post) - POST /projects/{project_id}/messages.json. |
| `basecamp_update_message` | Update a message - PUT /projects/{project_id}/messages/{id}.json. |
| `basecamp_list_comments` | List comments on an object (message, to-do, document, etc.) - GET /projects/{project_id}/{parent_id}/comments.json. |
| `basecamp_get_comment` | Get one comment - GET /projects/{project_id}/comments/{id}.json. |
| `basecamp_create_comment` | Create a comment on an object - POST /projects/{project_id}/{parent_id}/comments.json. |
| `basecamp_update_comment` | Update a comment - PUT /projects/{project_id}/comments/{id}.json. |
| `basecamp_list_people` | List people with access to a project - GET /projects/{project_id}/people.json. |
| `basecamp_get_person` | Get one person - GET /people/{id}.json. |
| `basecamp_list_schedules` | List schedules (calendars) in a project - GET /projects/{project_id}/schedules.json. |
| `basecamp_get_schedule` | Get one schedule - GET /projects/{project_id}/schedules/{id}.json. |
| `basecamp_list_schedule_entries` | List schedule entries (events) in a calendar - GET /projects/{project_id}/schedules/{schedule_id}/entries.json. |
| `basecamp_get_schedule_entry` | Get one schedule entry (event) - GET /projects/{project_id}/schedules/{schedule_id}/entries/{id}.json. |
| `basecamp_create_schedule_entry` | Create a schedule entry (event) - POST /projects/{project_id}/schedules/{schedule_id}/entries.json. |
| `basecamp_update_schedule_entry` | Update a schedule entry - PUT /projects/{project_id}/schedule_entries/{id}.json. |
| `basecamp_list_documents` | List documents in a project - GET /projects/{project_id}/documents.json. |
| `basecamp_get_document` | Get one document - GET /projects/{project_id}/documents/{id}.json. |
| `basecamp_create_document` | Create a document - POST /projects/{project_id}/documents.json. |
| `basecamp_update_document` | Update a document - PUT /projects/{project_id}/documents/{id}.json. |
| `basecamp_list_vaults` | List document vaults in a project - GET /projects/{project_id}/vaults.json. |
| `basecamp_list_files` | List files in a project - GET /projects/{project_id}/files.json. |
| `basecamp_get_file` | Get one file - GET /projects/{project_id}/files/{id}.json. |

## How to get credentials

This connector uses **OAuth 2.0**. In FlyMyAI, open the tool and click
**Connect** - you'll be redirected to Basecamp to authorize, then back to
FlyMyAI. There is no API key to paste.

> The OAuth app must be registered by FlyMyAI for this provider. If you see
> *"connection not configured"*, the provider's client credentials are still
> being set up - check back shortly.

## Fields to fill in FlyMyAI

| FlyMyAI field | Where it comes from |
| --- | --- |
| _(none)_ | Connect via OAuth - nothing to paste. |

## Troubleshooting

- **`401 Unauthorized` / `403 Forbidden`** - the OAuth connection expired or was revoked - reconnect.
- **`429 Too Many Requests`** - you hit the provider rate limit; retry after a short backoff.
- **Unexpected `4xx` on writes** - double-check required fields; the agent confirms before write actions.

## Links

- [Basecamp API documentation](https://github.com/basecamp/bc3-api)