> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Float

> Float is a resource management and project planning platform for scheduling teams, managing project capacity, tracking time, and reporting on utilization.

![Float logo](https://mintcdn.com/composio-preview/GL28i3tBlbEbBd-f/images/toolkits/float.svg?fit=max\&auto=format\&n=GL28i3tBlbEbBd-f\&q=85\&s=6e1062c64e6a8a6f8badb082ad9542e5)

* **Category:** project management
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 10
* **Triggers:** 0
* **Slug:** `FLOAT`
* **Version:** 20261101\_00

## Tools

> [accordion] Create Allocation
>
> **Slug:** `FLOAT_CREATE_ALLOCATION`
>
> Schedule work on a Float project for one or more people, or leave it unassigned, with optional phase, status, notes, and recurrence. Supplying a project-task name may create that project-task definition when none matches.
>
> #### Input Parameters
>
> **notes** `string`
>
> Details about the scheduled work.
>
> **status** `string ("draft" | "tentative" | "confirmed" | "complete" | "canceled")`
>
> Initial allocation status.
>
> **end\_date** `string` *required*
>
> Allocation end date in YYYY-MM-DD format; must not precede start\_date.
>
> **phase\_id** `integer`
>
> Project phase ID for the allocation.
>
> **people\_ids** `array`
>
> One or more positive person IDs to assign; omit to create an unassigned allocation.
>
> **project\_id** `integer` *required*
>
> ID of the project receiving the allocation.
>
> **recurrence** `string ("none" | "weekly" | "monthly" | "every_two_weeks" | "every_three_weeks" | "every_six_weeks" | "every_two_months" | "every_three_months" | "every_six_months" | "yearly")`
>
> How often the allocation repeats.
>
> **start\_date** `string` *required*
>
> Allocation start date in YYYY-MM-DD format.
>
> **start\_time** `string`
>
> Optional daily start time in 24-hour HH:MM format.
>
> **hours\_per\_day** `number` *required*
>
> Hours scheduled per working day; must be greater than zero.
>
> **project\_task\_id** `integer`
>
> Existing project task ID; takes precedence over project\_task\_name.
>
> **repeat\_end\_date** `string`
>
> Last date for a repeating allocation in YYYY-MM-DD format. Allowed only when recurrence is not none and must not precede end\_date.
>
> **project\_task\_name** `string`
>
> Project task name. Float may create the project-task definition when no matching name exists. Ignored when project\_task\_id is supplied.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Project
>
> **Slug:** `FLOAT_CREATE_PROJECT`
>
> Create a Float project with core scheduling and classification fields. This tool intentionally excludes rates, currencies, budgets, and project-team replacement operations.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Name of the new project.
>
> **tags** `array`
>
> Tags to assign to the project.
>
> **color** `string`
>
> Project color as a hexadecimal value.
>
> **notes** `string`
>
> Planning notes for the project.
>
> **status** `string ("draft" | "tentative" | "confirmed" | "completed" | "canceled")`
>
> Initial lifecycle status. Float automatically selects the first configured project stage matching this status.
>
> **billable** `boolean`
>
> Whether work on this project is billable.
>
> **end\_date** `string`
>
> Project end date in YYYY-MM-DD format; must not precede start\_date.
>
> **client\_id** `integer`
>
> ID of the client that owns the project.
>
> **start\_date** `string`
>
> Project start date in YYYY-MM-DD format.
>
> **project\_code** `string`
>
> Optional third-party project identifier, unique across projects case-insensitively.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get People Capacity Report
>
> **Slug:** `FLOAT_GET_PEOPLE_CAPACITY_REPORT`
>
> Return person-level capacity, scheduled, unscheduled, time-off, billable, and non-billable totals for a required date range.
>
> #### Input Parameters
>
> **end\_date** `string` *required*
>
> Report end date in YYYY-MM-DD format; must not precede start\_date.
>
> **people\_id** `integer`
>
> Return report data only for this person ID.
>
> **start\_date** `string` *required*
>
> Report start date in YYYY-MM-DD format.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Project
>
> **Slug:** `FLOAT_GET_PROJECT`
>
> Retrieve one Float project by ID, optionally including its phases, project tasks, team, expenses, or currency details.
>
> #### Input Parameters
>
> **include** `array`
>
> Related project details to include in the response.
>
> **project\_id** `integer` *required*
>
> ID of the project to retrieve.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Project Utilization Report
>
> **Slug:** `FLOAT_GET_PROJECT_UTILIZATION_REPORT`
>
> Return project-level scheduled, logged, billable, non-billable, budget, and utilization totals for a required date range, optionally for one project.
>
> #### Input Parameters
>
> **end\_date** `string` *required*
>
> Report end date in YYYY-MM-DD format; must not precede start\_date.
>
> **project\_id** `integer`
>
> Return report data only for this project ID.
>
> **start\_date** `string` *required*
>
> Report start date in YYYY-MM-DD format.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Allocations
>
> **Slug:** `FLOAT_LIST_ALLOCATIONS`
>
> Find scheduled allocations in Float by project, person, client, phase, project task, date range, billing state, status, or recurrence.
>
> #### Input Parameters
>
> **sort** `string`
>
> Supported field to sort ascending; prefix with '-' for descending.
>
> **status** `string ("tentative" | "confirmed" | "complete")`
>
> Return allocations in this status.
>
> **billable** `boolean`
>
> Return billable allocations when true or non-billable allocations when false.
>
> **end\_date** `string`
>
> Inclusive range end in YYYY-MM-DD format; provide together with start\_date.
>
> **per\_page** `integer`
>
> Maximum allocations to return in this page (1-200).
>
> **phase\_id** `integer`
>
> Return allocations for this project phase ID.
>
> **client\_id** `integer`
>
> Return allocations for projects belonging to this client ID.
>
> **people\_id** `integer`
>
> Return allocations assigned to this person ID.
>
> **project\_id** `integer`
>
> Return allocations for this project ID.
>
> **recurrence** `string ("none" | "weekly" | "monthly" | "every_two_weeks" | "every_three_weeks" | "every_six_weeks" | "every_two_months" | "every_three_months" | "every_six_months" | "yearly")`
>
> Return allocations with this recurrence schedule.
>
> **start\_date** `string`
>
> Inclusive range start in YYYY-MM-DD format; provide together with end\_date.
>
> **next\_cursor** `string`
>
> Opaque cursor from a previous response; when supplied it restores that query's filters and fetches the next page.
>
> **modified\_since** `string`
>
> Return records modified at or after this YYYY-MM-DD HH:MM:SS value or Unix timestamp.
>
> **project\_task\_id** `integer`
>
> Return allocations associated with this project task ID.
>
> **include\_task\_days** `boolean`
>
> Include calculated working dates for each allocation; requires both start\_date and end\_date.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List People
>
> **Slug:** `FLOAT_LIST_PEOPLE`
>
> Find active people on the Float schedule by default, or filter for archived or all people, employee type, department, and tags. Optionally include related account details.
>
> #### Input Parameters
>
> **sort** `string`
>
> Supported field to sort ascending; prefix with '-' for descending.
>
> **tags** `array`
>
> Return records matching any exact tag name, case-insensitively.
>
> **email** `string`
>
> Return the person whose email exactly matches this value, case-insensitively.
>
> **active** `boolean`
>
> Return active people when true (the default), archived people when false, or both when explicitly set to null.
>
> **include** `array`
>
> Related details to include in each person record.
>
> **per\_page** `integer`
>
> Maximum people to return in this page (1-200).
>
> **employment** `string ("full_time" | "part_time")`
>
> Return only full-time or part-time people.
>
> **next\_cursor** `string`
>
> Opaque cursor from a previous response; when supplied it restores that query's filters and fetches the next page.
>
> **people\_types** `array`
>
> Return only these person types; role placeholders are not returned unless requested.
>
> **department\_id** `integer`
>
> Return only people in this department ID.
>
> **modified\_since** `string`
>
> Return records modified at or after this YYYY-MM-DD HH:MM:SS value or Unix timestamp.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Projects
>
> **Slug:** `FLOAT_LIST_PROJECTS`
>
> Find Float projects by code, client, lifecycle state, billing state, status, or tags, optionally including planning details such as phases, tasks, team, and currency.
>
> #### Input Parameters
>
> **sort** `string`
>
> Supported field to sort ascending; prefix with '-' for descending.
>
> **tags** `array`
>
> Return records matching any exact tag name, case-insensitively.
>
> **active** `boolean`
>
> Return active projects when true or archived projects when false.
>
> **status** `string ("draft" | "tentative" | "confirmed" | "completed" | "canceled")`
>
> Return projects in this lifecycle status.
>
> **include** `array`
>
> Related project details to include in each record.
>
> **billable** `boolean`
>
> Return billable projects when true or non-billable projects when false.
>
> **per\_page** `integer`
>
> Maximum projects to return in this page (1-200).
>
> **client\_id** `integer`
>
> Return only projects belonging to this client ID.
>
> **next\_cursor** `string`
>
> Opaque cursor from a previous response; when supplied it restores that query's filters and fetches the next page.
>
> **project\_code** `string`
>
> Return the project whose unique project code exactly matches this value, case-insensitively.
>
> **modified\_since** `string`
>
> Return records modified at or after this YYYY-MM-DD HH:MM:SS value or Unix timestamp.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Allocation
>
> **Slug:** `FLOAT_UPDATE_ALLOCATION`
>
> Reschedule or revise selected fields of a Float allocation. Sends only fields explicitly supplied by the caller and preserves Float task IDs in the result. Supplying a project-task name may create that project-task definition when none matches.
>
> #### Input Parameters
>
> **notes** `string`
>
> Non-empty replacement details about the scheduled work.
>
> **status** `string ("draft" | "tentative" | "confirmed" | "complete" | "canceled")`
>
> New allocation status.
>
> **end\_date** `string`
>
> New allocation end date in YYYY-MM-DD format.
>
> **phase\_id** `integer`
>
> New project phase ID, or null to remove the phase association when Float permits it.
>
> **people\_ids** `array`
>
> Non-empty replacement list of person IDs assigned to the allocation.
>
> **recurrence** `string ("none" | "weekly" | "monthly" | "every_two_weeks" | "every_three_weeks" | "every_six_weeks" | "every_two_months" | "every_three_months" | "every_six_months" | "yearly")`
>
> New recurrence schedule.
>
> **start\_date** `string`
>
> New allocation start date in YYYY-MM-DD format.
>
> **start\_time** `string`
>
> New daily start time in 24-hour HH:MM format, or null to clear it.
>
> **allocation\_id** `integer` *required*
>
> Float task\_id of the allocation to update.
>
> **hours\_per\_day** `number`
>
> New number of hours scheduled per working day; must be greater than zero.
>
> **project\_task\_id** `integer`
>
> New project task ID, or null to clear it; do not combine with project\_task\_name.
>
> **repeat\_end\_date** `string`
>
> New recurrence end date in YYYY-MM-DD format, or null to clear it.
>
> **project\_task\_name** `string`
>
> New non-empty project task name when project\_task\_id is not supplied. Float may create the project-task definition when no matching name exists.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Project
>
> **Slug:** `FLOAT_UPDATE_PROJECT`
>
> Update selected core identity, schedule, lifecycle, and tag fields on a Float project. This tool does not expose financial configuration or project-team replacement and removal operations.
>
> #### Input Parameters
>
> **name** `string`
>
> New project name.
>
> **tags** `array`
>
> Complete replacement list of project tags; an empty list removes all tags.
>
> **color** `string`
>
> New project color as a hexadecimal value.
>
> **notes** `string`
>
> Replacement planning notes.
>
> **active** `boolean`
>
> Set false to archive the project or true to reactivate it.
>
> **status** `string ("draft" | "tentative" | "confirmed" | "completed" | "canceled")`
>
> New lifecycle status; Float selects the first configured stage for that status.
>
> **billable** `boolean`
>
> Whether work on this project is billable.
>
> **end\_date** `string`
>
> New project end date in YYYY-MM-DD format; must not precede start\_date when both are supplied.
>
> **client\_id** `integer`
>
> New client ID, or null to detach the project when Float permits it.
>
> **project\_id** `integer` *required*
>
> ID of the project to update.
>
> **start\_date** `string`
>
> New project start date in YYYY-MM-DD format.
>
> **project\_code** `string`
>
> New third-party project identifier, unique across projects case-insensitively.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
