Skip to main content
Float logo
  • Category: project management
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 10
  • Triggers: 0
  • Slug: FLOAT
  • Version: 20261101_00

Tools

Slug: FLOAT_CREATE_ALLOCATIONSchedule 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

string
Details about the scheduled work.
string ("draft" | "tentative" | "confirmed" | "complete" | "canceled")
Initial allocation status.
string
required
Allocation end date in YYYY-MM-DD format; must not precede start_date.
integer
Project phase ID for the allocation.
array
One or more positive person IDs to assign; omit to create an unassigned allocation.
integer
required
ID of the project receiving the allocation.
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.
string
required
Allocation start date in YYYY-MM-DD format.
string
Optional daily start time in 24-hour HH:MM format.
number
required
Hours scheduled per working day; must be greater than zero.
integer
Existing project task ID; takes precedence over project_task_name.
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.
string
Project task name. Float may create the project-task definition when no matching name exists. Ignored when project_task_id is supplied.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: FLOAT_CREATE_PROJECTCreate a Float project with core scheduling and classification fields. This tool intentionally excludes rates, currencies, budgets, and project-team replacement operations.

Input Parameters

string
required
Name of the new project.
array
Tags to assign to the project.
string
Project color as a hexadecimal value.
string
Planning notes for the project.
string ("draft" | "tentative" | "confirmed" | "completed" | "canceled")
Initial lifecycle status. Float automatically selects the first configured project stage matching this status.
boolean
Whether work on this project is billable.
string
Project end date in YYYY-MM-DD format; must not precede start_date.
integer
ID of the client that owns the project.
string
Project start date in YYYY-MM-DD format.
string
Optional third-party project identifier, unique across projects case-insensitively.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: FLOAT_GET_PEOPLE_CAPACITY_REPORTReturn person-level capacity, scheduled, unscheduled, time-off, billable, and non-billable totals for a required date range.

Input Parameters

string
required
Report end date in YYYY-MM-DD format; must not precede start_date.
integer
Return report data only for this person ID.
string
required
Report start date in YYYY-MM-DD format.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: FLOAT_GET_PROJECTRetrieve one Float project by ID, optionally including its phases, project tasks, team, expenses, or currency details.

Input Parameters

array
Related project details to include in the response.
integer
required
ID of the project to retrieve.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: FLOAT_GET_PROJECT_UTILIZATION_REPORTReturn project-level scheduled, logged, billable, non-billable, budget, and utilization totals for a required date range, optionally for one project.

Input Parameters

string
required
Report end date in YYYY-MM-DD format; must not precede start_date.
integer
Return report data only for this project ID.
string
required
Report start date in YYYY-MM-DD format.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: FLOAT_LIST_ALLOCATIONSFind scheduled allocations in Float by project, person, client, phase, project task, date range, billing state, status, or recurrence.

Input Parameters

string
Supported field to sort ascending; prefix with ’-’ for descending.
string ("tentative" | "confirmed" | "complete")
Return allocations in this status.
boolean
Return billable allocations when true or non-billable allocations when false.
string
Inclusive range end in YYYY-MM-DD format; provide together with start_date.
integer
Maximum allocations to return in this page (1-200).
integer
Return allocations for this project phase ID.
integer
Return allocations for projects belonging to this client ID.
integer
Return allocations assigned to this person ID.
integer
Return allocations for this project ID.
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.
string
Inclusive range start in YYYY-MM-DD format; provide together with end_date.
string
Opaque cursor from a previous response; when supplied it restores that query’s filters and fetches the next page.
string
Return records modified at or after this YYYY-MM-DD HH:MM:SS value or Unix timestamp.
integer
Return allocations associated with this project task ID.
boolean
Include calculated working dates for each allocation; requires both start_date and end_date.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: FLOAT_LIST_PEOPLEFind 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

string
Supported field to sort ascending; prefix with ’-’ for descending.
array
Return records matching any exact tag name, case-insensitively.
string
Return the person whose email exactly matches this value, case-insensitively.
boolean
Return active people when true (the default), archived people when false, or both when explicitly set to null.
array
Related details to include in each person record.
integer
Maximum people to return in this page (1-200).
string ("full_time" | "part_time")
Return only full-time or part-time people.
string
Opaque cursor from a previous response; when supplied it restores that query’s filters and fetches the next page.
array
Return only these person types; role placeholders are not returned unless requested.
integer
Return only people in this department ID.
string
Return records modified at or after this YYYY-MM-DD HH:MM:SS value or Unix timestamp.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: FLOAT_LIST_PROJECTSFind 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

string
Supported field to sort ascending; prefix with ’-’ for descending.
array
Return records matching any exact tag name, case-insensitively.
boolean
Return active projects when true or archived projects when false.
string ("draft" | "tentative" | "confirmed" | "completed" | "canceled")
Return projects in this lifecycle status.
array
Related project details to include in each record.
boolean
Return billable projects when true or non-billable projects when false.
integer
Maximum projects to return in this page (1-200).
integer
Return only projects belonging to this client ID.
string
Opaque cursor from a previous response; when supplied it restores that query’s filters and fetches the next page.
string
Return the project whose unique project code exactly matches this value, case-insensitively.
string
Return records modified at or after this YYYY-MM-DD HH:MM:SS value or Unix timestamp.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: FLOAT_UPDATE_ALLOCATIONReschedule 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

string
Non-empty replacement details about the scheduled work.
string ("draft" | "tentative" | "confirmed" | "complete" | "canceled")
New allocation status.
string
New allocation end date in YYYY-MM-DD format.
integer
New project phase ID, or null to remove the phase association when Float permits it.
array
Non-empty replacement list of person IDs assigned to the allocation.
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.
string
New allocation start date in YYYY-MM-DD format.
string
New daily start time in 24-hour HH:MM format, or null to clear it.
integer
required
Float task_id of the allocation to update.
number
New number of hours scheduled per working day; must be greater than zero.
integer
New project task ID, or null to clear it; do not combine with project_task_name.
string
New recurrence end date in YYYY-MM-DD format, or null to clear it.
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: FLOAT_UPDATE_PROJECTUpdate 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

string
New project name.
array
Complete replacement list of project tags; an empty list removes all tags.
string
New project color as a hexadecimal value.
string
Replacement planning notes.
boolean
Set false to archive the project or true to reactivate it.
string ("draft" | "tentative" | "confirmed" | "completed" | "canceled")
New lifecycle status; Float selects the first configured stage for that status.
boolean
Whether work on this project is billable.
string
New project end date in YYYY-MM-DD format; must not precede start_date when both are supplied.
integer
New client ID, or null to detach the project when Float permits it.
integer
required
ID of the project to update.
string
New project start date in YYYY-MM-DD format.
string
New third-party project identifier, unique across projects case-insensitively.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not