Server path:Documentation Index
Fetch the complete documentation index at: https://docs.pinkfish.ai/llms.txt
Use this file to discover all available pages before exploring further.
/basecamp-tasks | Type: Application | PCID required: Yes
Tools
| Tool | Description |
|---|---|
basecamp_tasks_complete_todo | Mark a todo as complete |
basecamp_tasks_create_card | Create a card in a column |
basecamp_tasks_create_card_column | Create a column in a card table |
basecamp_tasks_create_card_step | Create a step on a card |
basecamp_tasks_create_gauge_needle | Create a gauge needle (progress update) for a project |
basecamp_tasks_create_schedule_entry | Create a new schedule entry |
basecamp_tasks_create_timesheet_entry | Create a timesheet entry on a recording |
basecamp_tasks_create_todo | Create a new todo in a todolist |
basecamp_tasks_create_todolist | Create a new todolist in a todoset |
basecamp_tasks_create_todolist_group | Create a new group in a todolist |
basecamp_tasks_destroy_gauge_needle | Destroy a gauge needle |
basecamp_tasks_disable_card_column_on_hold | Disable on-hold section in a column |
basecamp_tasks_enable_card_column_on_hold | Enable on-hold section in a column |
basecamp_tasks_get_card | Get a card by ID |
basecamp_tasks_get_card_column | Get a card column by ID |
basecamp_tasks_get_card_step | Get a step by ID |
basecamp_tasks_get_card_table | Get a card table by ID |
basecamp_tasks_get_gauge_needle | Get a gauge needle by ID |
basecamp_tasks_get_hill_chart | Get the hill chart for a todoset |
basecamp_tasks_get_project_timesheet | Get timesheet for a specific project |
basecamp_tasks_get_recording_timesheet | Get timesheet for a specific recording |
basecamp_tasks_get_schedule | Get a schedule |
basecamp_tasks_get_schedule_entry | Get a single schedule entry by id. Note: Recurring entries will redirect (302) to their recordable URL. Use GetScheduleEntryOccurrence for recurring entries instead. |
basecamp_tasks_get_schedule_entry_occurrence | Get a specific occurrence of a recurring schedule entry |
basecamp_tasks_get_timesheet_entry | Get a single timesheet entry |
basecamp_tasks_get_timesheet_report | Get account-wide timesheet report |
basecamp_tasks_get_todo | Get a single todo by id |
basecamp_tasks_get_todolist_or_group | Get a single todolist or todolist group by id The endpoint is polymorphic - the same URI returns either a Todolist or TodolistGroup |
basecamp_tasks_get_todoset | Get a todoset (container for todolists in a project) |
basecamp_tasks_list_cards | List cards in a column Pagination: Uses Link header (RFC5988). Follow the next rel URL to fetch additional pages. X-Total-Count header provides total count. |
basecamp_tasks_list_gauge_needles | List gauge needles for a project, ordered newest first. |
basecamp_tasks_list_gauges | List gauges across all projects the authenticated user has access to. Gauges are sorted by risk level (red, yellow, green), then alphabetically. |
basecamp_tasks_list_schedule_entries | List entries on a schedule Pagination: Uses Link header (RFC5988). Follow the next rel URL to fetch additional pages. X-Total-Count header provides total count. |
basecamp_tasks_list_todolist_groups | List groups in a todolist Pagination: Uses Link header (RFC5988). Follow the next rel URL to fetch additional pages. X-Total-Count header provides total count. |
basecamp_tasks_list_todolists | List todolists in a todoset Pagination: Uses Link header (RFC5988). Follow the next rel URL to fetch additional pages. X-Total-Count header provides total count. |
basecamp_tasks_list_todos | List todos in a todolist Pagination: Uses Link header (RFC5988). Follow the next rel URL to fetch additional pages. X-Total-Count header provides total count. |
basecamp_tasks_move_card | Move a card to a different column |
basecamp_tasks_move_card_column | Move a column within a card table |
basecamp_tasks_reposition_card_step | Reposition a step within a card |
basecamp_tasks_reposition_todo | Reposition a todo within its todolist |
basecamp_tasks_reposition_todolist_group | Reposition a todolist group |
basecamp_tasks_set_card_column_color | Set the color of a column |
basecamp_tasks_set_card_step_completion | Set card step completion status (PUT with completion: “on” to complete, "" to uncomplete) |
basecamp_tasks_subscribe_to_card_column | Subscribe to a card column (watch for changes) |
basecamp_tasks_toggle_gauge | Enable or disable the gauge for a project. Only project admins can toggle gauges. |
basecamp_tasks_trash_todo | Trash a todo (returns 204 No Content) |
basecamp_tasks_uncomplete_todo | Mark a todo as incomplete |
basecamp_tasks_unsubscribe_from_card_column | Unsubscribe from a card column (stop watching for changes) |
basecamp_tasks_update_card | Update an existing card |
basecamp_tasks_update_card_column | Update an existing column |
basecamp_tasks_update_card_step | Update an existing step |
basecamp_tasks_update_gauge_needle | Update a gauge needle’s description. Position and color are immutable. |
basecamp_tasks_update_hill_chart_settings | Track or untrack todolists on a hill chart |
basecamp_tasks_update_schedule_entry | Update an existing schedule entry |
basecamp_tasks_update_schedule_settings | Update schedule settings |
basecamp_tasks_update_timesheet_entry | Update a timesheet entry |
basecamp_tasks_update_todo | Update an existing todo |
basecamp_tasks_update_todolist_or_group | Update an existing todolist or todolist group The endpoint is polymorphic - updates either a Todolist or TodolistGroup |
basecamp_tasks_complete_todo
Mark a todo as complete Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
todoId | integer | Yes | — | Todo Id |
basecamp_tasks_create_card
Create a card in a column Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
columnId | integer | Yes | — | Column Id |
content | string | No | — | The content value |
due_on | string | No | — | Due On |
notify | boolean | No | — | The notify value |
title | string | Yes | — | The title value |
basecamp_tasks_create_card_column
Create a column in a card table Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
cardTableId | integer | Yes | — | Card Table Id |
description | string | No | — | The description value |
title | string | Yes | — | The title value |
basecamp_tasks_create_card_step
Create a step on a card Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
cardId | integer | Yes | — | Card Id |
assignee_ids | integer[] | No | — | Assignee Ids |
due_on | string | No | — | Due On |
title | string | Yes | — | The title value |
basecamp_tasks_create_gauge_needle
Create a gauge needle (progress update) for a project Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
projectId | integer | Yes | — | Project Id |
gauge_needle | object | Yes | — | Gauge Needle |
notify | string | No | — | Who to notify: “everyone”, “working_on”, “custom”, or omit for nobody |
subscriptions | integer[] | No | — | Array of people IDs to notify (only used when notify is “custom”) |
basecamp_tasks_create_schedule_entry
Create a new schedule entry Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
scheduleId | integer | Yes | — | Schedule Id |
all_day | boolean | No | — | All Day |
description | string | No | — | The description value |
ends_at | string | Yes | — | Ends At |
notify | boolean | No | — | The notify value |
participant_ids | integer[] | No | — | Participant Ids |
starts_at | string | Yes | — | Starts At |
subscriptions | integer[] | No | — | The subscriptions value |
summary | string | Yes | — | The summary value |
basecamp_tasks_create_timesheet_entry
Create a timesheet entry on a recording Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
recordingId | integer | Yes | — | Recording Id |
date | string | Yes | — | The date value |
description | string | No | — | The description value |
hours | string | Yes | — | The hours value |
person_id | integer | No | — | Person Id |
basecamp_tasks_create_todo
Create a new todo in a todolist Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
todolistId | integer | Yes | — | Todolist Id |
assignee_ids | integer[] | No | — | Assignee Ids |
completion_subscriber_ids | integer[] | No | — | Completion Subscriber Ids |
content | string | Yes | — | The content value |
description | string | No | — | The description value |
due_on | string | No | — | Due On |
notify | boolean | No | — | The notify value |
starts_on | string | No | — | Starts On |
basecamp_tasks_create_todolist
Create a new todolist in a todoset Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
todosetId | integer | Yes | — | Todoset Id |
description | string | No | — | The description value |
name | string | Yes | — | The name value |
basecamp_tasks_create_todolist_group
Create a new group in a todolist Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
todolistId | integer | Yes | — | Todolist Id |
name | string | Yes | — | The name value |
basecamp_tasks_destroy_gauge_needle
Destroy a gauge needle Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
needleId | integer | Yes | — | Needle Id |
basecamp_tasks_disable_card_column_on_hold
Disable on-hold section in a column Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
bucketId | integer | Yes | — | Bucket Id |
columnId | integer | Yes | — | Column Id |
basecamp_tasks_enable_card_column_on_hold
Enable on-hold section in a column Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
bucketId | integer | Yes | — | Bucket Id |
columnId | integer | Yes | — | Column Id |
basecamp_tasks_get_card
Get a card by ID Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
cardId | integer | Yes | — | Card Id |
basecamp_tasks_get_card_column
Get a card column by ID Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
columnId | integer | Yes | — | Column Id |
basecamp_tasks_get_card_step
Get a step by ID Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
stepId | integer | Yes | — | Step Id |
basecamp_tasks_get_card_table
Get a card table by ID Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
cardTableId | integer | Yes | — | Card Table Id |
basecamp_tasks_get_gauge_needle
Get a gauge needle by ID Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
needleId | integer | Yes | — | Needle Id |
basecamp_tasks_get_hill_chart
Get the hill chart for a todoset Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
todosetId | integer | Yes | — | Todoset Id |
basecamp_tasks_get_project_timesheet
Get timesheet for a specific project Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
projectId | integer | Yes | — | Project Id |
from | string | No | — | The from value |
to | string | No | — | The to value |
person_id | integer | No | — | Person Id |
basecamp_tasks_get_recording_timesheet
Get timesheet for a specific recording Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
recordingId | integer | Yes | — | Recording Id |
from | string | No | — | The from value |
to | string | No | — | The to value |
person_id | integer | No | — | Person Id |
basecamp_tasks_get_schedule
Get a schedule Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
scheduleId | integer | Yes | — | Schedule Id |
basecamp_tasks_get_schedule_entry
Get a single schedule entry by id. Note: Recurring entries will redirect (302) to their recordable URL. Use GetScheduleEntryOccurrence for recurring entries instead. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
entryId | integer | Yes | — | Entry Id |
basecamp_tasks_get_schedule_entry_occurrence
Get a specific occurrence of a recurring schedule entry Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
entryId | integer | Yes | — | Entry Id |
date | string | Yes | — | The date value |
basecamp_tasks_get_timesheet_entry
Get a single timesheet entry Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
entryId | integer | Yes | — | Entry Id |
basecamp_tasks_get_timesheet_report
Get account-wide timesheet report Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
from | string | No | — | The from value |
to | string | No | — | The to value |
person_id | integer | No | — | Person Id |
basecamp_tasks_get_todo
Get a single todo by id Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
todoId | integer | Yes | — | Todo Id |
basecamp_tasks_get_todolist_or_group
Get a single todolist or todolist group by id The endpoint is polymorphic - the same URI returns either a Todolist or TodolistGroup Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | The id value |
basecamp_tasks_get_todoset
Get a todoset (container for todolists in a project) Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
todosetId | integer | Yes | — | Todoset Id |
basecamp_tasks_list_cards
List cards in a column Pagination: Uses Link header (RFC5988). Follow thenext rel URL to fetch additional pages. X-Total-Count header provides total count.
Parameters:
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
columnId | integer | Yes | — | Column Id |
basecamp_tasks_list_gauge_needles
List gauge needles for a project, ordered newest first. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
projectId | integer | Yes | — | Project Id |
basecamp_tasks_list_gauges
List gauges across all projects the authenticated user has access to. Gauges are sorted by risk level (red, yellow, green), then alphabetically. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
bucket_ids | string | No | — | Comma-separated list of project IDs. When provided, results are returned in the order specified instead of by risk level. |
basecamp_tasks_list_schedule_entries
List entries on a schedule Pagination: Uses Link header (RFC5988). Follow thenext rel URL to fetch additional pages. X-Total-Count header provides total count.
Parameters:
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
scheduleId | integer | Yes | — | Schedule Id |
status | string | No | — | active|archived|trashed |
basecamp_tasks_list_todolist_groups
List groups in a todolist Pagination: Uses Link header (RFC5988). Follow thenext rel URL to fetch additional pages. X-Total-Count header provides total count.
Parameters:
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
todolistId | integer | Yes | — | Todolist Id |
basecamp_tasks_list_todolists
List todolists in a todoset Pagination: Uses Link header (RFC5988). Follow thenext rel URL to fetch additional pages. X-Total-Count header provides total count.
Parameters:
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
todosetId | integer | Yes | — | Todoset Id |
status | string | No | — | active|archived|trashed |
basecamp_tasks_list_todos
List todos in a todolist Pagination: Uses Link header (RFC5988). Follow thenext rel URL to fetch additional pages. X-Total-Count header provides total count.
Parameters:
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
todolistId | integer | Yes | — | Todolist Id |
status | string | No | — | active|archived|trashed |
completed | boolean | No | — | The completed value |
basecamp_tasks_move_card
Move a card to a different column Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
cardId | integer | Yes | — | Card Id |
column_id | integer | Yes | — | Column Id |
position | integer | No | — | 1-indexed position within the destination column. Defaults to 1 (top). |
basecamp_tasks_move_card_column
Move a column within a card table Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
cardTableId | integer | Yes | — | Card Table Id |
position | integer | No | — | The position value |
source_id | integer | Yes | — | Source Id |
target_id | integer | Yes | — | Target Id |
basecamp_tasks_reposition_card_step
Reposition a step within a card Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
cardId | integer | Yes | — | Card Id |
position | integer | Yes | — | 0-indexed position |
source_id | integer | Yes | — | Source Id |
basecamp_tasks_reposition_todo
Reposition a todo within its todolist Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
todoId | integer | Yes | — | Todo Id |
parent_id | integer | No | — | Optional todolist ID to move the todo to a different parent |
position | integer | Yes | — | The position value |
basecamp_tasks_reposition_todolist_group
Reposition a todolist group Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
groupId | integer | Yes | — | Group Id |
position | integer | Yes | — | The position value |
basecamp_tasks_set_card_column_color
Set the color of a column Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
bucketId | integer | Yes | — | Bucket Id |
columnId | integer | Yes | — | Column Id |
color | string | Yes | — | Valid colors: white, red, orange, yellow, green, blue, aqua, purple, gray, pink, brown |
basecamp_tasks_set_card_step_completion
Set card step completion status (PUT with completion: “on” to complete, "" to uncomplete) Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
stepId | integer | Yes | — | Step Id |
completion | string | Yes | — | Set to “on” to complete the step, "" (empty) to uncomplete |
basecamp_tasks_subscribe_to_card_column
Subscribe to a card column (watch for changes) Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
columnId | integer | Yes | — | Column Id |
basecamp_tasks_toggle_gauge
Enable or disable the gauge for a project. Only project admins can toggle gauges. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
projectId | integer | Yes | — | Project Id |
gauge | object | Yes | — | The gauge value |
basecamp_tasks_trash_todo
Trash a todo (returns 204 No Content) Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
todoId | integer | Yes | — | Todo Id |
basecamp_tasks_uncomplete_todo
Mark a todo as incomplete Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
todoId | integer | Yes | — | Todo Id |
basecamp_tasks_unsubscribe_from_card_column
Unsubscribe from a card column (stop watching for changes) Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
columnId | integer | Yes | — | Column Id |
basecamp_tasks_update_card
Update an existing card Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
cardId | integer | Yes | — | Card Id |
assignee_ids | integer[] | No | — | Assignee Ids |
content | string | No | — | The content value |
due_on | string | No | — | Due On |
title | string | No | — | The title value |
basecamp_tasks_update_card_column
Update an existing column Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
columnId | integer | Yes | — | Column Id |
description | string | No | — | The description value |
title | string | No | — | The title value |
basecamp_tasks_update_card_step
Update an existing step Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
stepId | integer | Yes | — | Step Id |
assignee_ids | integer[] | No | — | Assignee Ids |
due_on | string | No | — | Due On |
title | string | No | — | The title value |
basecamp_tasks_update_gauge_needle
Update a gauge needle’s description. Position and color are immutable. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
needleId | integer | Yes | — | Needle Id |
gauge_needle | object | No | — | Gauge Needle |
basecamp_tasks_update_hill_chart_settings
Track or untrack todolists on a hill chart Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
todosetId | integer | Yes | — | Todoset Id |
tracked | integer[] | No | — | The tracked value |
untracked | integer[] | No | — | The untracked value |
basecamp_tasks_update_schedule_entry
Update an existing schedule entry Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
entryId | integer | Yes | — | Entry Id |
all_day | boolean | No | — | All Day |
description | string | No | — | The description value |
ends_at | string | No | — | Ends At |
notify | boolean | No | — | The notify value |
participant_ids | integer[] | No | — | Participant Ids |
starts_at | string | No | — | Starts At |
summary | string | No | — | The summary value |
basecamp_tasks_update_schedule_settings
Update schedule settings Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
scheduleId | integer | Yes | — | Schedule Id |
include_due_assignments | boolean | Yes | — | Include Due Assignments |
basecamp_tasks_update_timesheet_entry
Update a timesheet entry Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
entryId | integer | Yes | — | Entry Id |
date | string | No | — | The date value |
description | string | No | — | The description value |
hours | string | No | — | The hours value |
person_id | integer | No | — | Person Id |
basecamp_tasks_update_todo
Update an existing todo Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
todoId | integer | Yes | — | Todo Id |
assignee_ids | integer[] | No | — | Assignee Ids |
completion_subscriber_ids | integer[] | No | — | Completion Subscriber Ids |
content | string | No | — | The content value |
description | string | No | — | The description value |
due_on | string | No | — | Due On |
notify | boolean | No | — | The notify value |
starts_on | string | No | — | Starts On |
basecamp_tasks_update_todolist_or_group
Update an existing todolist or todolist group The endpoint is polymorphic - updates either a Todolist or TodolistGroup Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | The id value |
description | string | No | — | Description (Todolist only, ignored for groups) |
name | string | No | — | Name (required for both Todolist and TodolistGroup) |

