Harvest integration: operations for AI agents
Harvest connects to Type.com as an integration. This page lists the 202 operations documented for Claude and Codex in Type.com: 92 read, 81 write, 29 destructive.
About Harvest
Harvest is a time-tracking and invoicing tool designed for teams and freelancers, helping them log billable hours, manage projects, and streamline payments
Categories: Productivity & Project Management
How to connect Harvest to Type.com
- Access
- Organization connection: one shared account for the workspace.
To add the connection, follow the steps in Space connections.
Documented operations
202 operations. Your connection's permissions determine which operations are available. API references describe the vendor surface; they do not expand your connection's credentials or access.
202 operations listed.
Approvals
- Read
List all approvals
Returns one period’s approvals, grouped by user. The response contains an object with an approvals property that contains an array of up to per_page approval objects, ordered by user name.
GET /v2/approvals - Write
Submit a timesheet for approval
Submits a user’s timesheet for a date range, moving their time entries and expenses in that range into the submitted bucket.
POST /v2/approvals/submit
Clients
- Read
List all clients
Returns a list of your clients. The clients are returned sorted by creation date, with the most recently created clients appearing first.
GET /v2/clients - Read
Retrieve a client
Retrieves the client with the given ID.
GET /v2/clients/{CLIENT_ID} - Write
Create a client
Creates a new client object.
POST /v2/clients - Write
Update a client
Updates the specific client by setting the values of the parameters passed. Any parameters not provided will be left unchanged.
PATCH /v2/clients/{CLIENT_ID} - Destructive
Delete a client
Delete a client. Deleting a client is only possible if it has no projects, invoices, or estimates associated with it.
DELETE /v2/clients/{CLIENT_ID}
Client Contacts
- Read
List all contacts
Returns a list of your contacts. The contacts are returned sorted by creation date, with the most recently created contacts appearing first.
GET /v2/contacts - Read
Retrieve a contact
Retrieves the contact with the given ID.
GET /v2/contacts/{CONTACT_ID} - Write
Create a contact
Creates a new contact object.
POST /v2/contacts - Write
Update a contact
Updates the specific contact by setting the values of the parameters passed. Any parameters not provided will be left unchanged.
PATCH /v2/contacts/{CONTACT_ID} - Destructive
Delete a contact
Delete a contact.
DELETE /v2/contacts/{CONTACT_ID}
Company
- Read
Retrieve a company
Retrieves the company for the currently authenticated user.
GET /v2/company - Read
Retrieve reimbursement settings
Retrieves the company’s expense reimbursement preferences.
GET /v2/company/reimbursement_settings - Write
Update a company
Updates the company setting the values of the parameters passed. Any parameters not provided will be left unchanged.
PATCH /v2/company - Write
Update reimbursement settings
Updates the company’s expense reimbursement preferences. Only the parameters provided are changed; any parameter omitted keeps its value.
PATCH /v2/company/reimbursement_settings - Write
Enroll in e-invoicing
Enrolls the company as a Peppol sender.
POST /v2/company/e_invoicing - Destructive
Disconnect from e-invoicing
Disconnects the company’s Peppol enrollment.
DELETE /v2/company/e_invoicing
Estimate Item Categories
- Read
List all estimate item categories
Returns a list of your estimate item categories. The estimate item categories are returned sorted by creation date, with the most recently created estimate item categories appearing first.
GET /v2/estimate_item_categories - Read
Retrieve an estimate item category
Retrieves the estimate item category with the given ID.
GET /v2/estimate_item_categories/{ESTIMATE_ITEM_CATEGORY_ID} - Write
Create an estimate item category
Creates a new estimate item category object.
POST /v2/estimate_item_categories - Write
Update an estimate item category
Updates the specific estimate item category by setting the values of the parameters passed. Any parameters not provided will be left unchanged.
PATCH /v2/estimate_item_categories/{ESTIMATE_ITEM_CATEGORY_ID} - Destructive
Delete an estimate item category
Delete an estimate item category.
DELETE /v2/estimate_item_categories/{ESTIMATE_ITEM_CATEGORY_ID}
Estimate Messages
- Read
List all messages for an estimate
Returns a list of messages associated with a given estimate. The estimate messages are returned sorted by creation date, with the most recently created messages appearing first.
GET /v2/estimates/{estimate_ID}/messages - Write
Create an estimate message
Creates a new estimate message object.
POST /v2/estimates/{estimate_ID}/messages - Destructive
Delete an estimate message
Delete an estimate message.
DELETE /v2/estimates/{estimate_ID}/messages/{message_ID}
Estimates
- Read
List all estimates
Returns a list of your estimates. The estimates are returned sorted by issue date, with the most recently issued estimates appearing first.
GET /v2/estimates - Read
Retrieve an estimate
Retrieves the estimate with the given ID.
GET /v2/estimates/{ESTIMATE_ID} - Write
Create an estimate
Creates a new estimate object.
POST /v2/estimates - Write
Update an estimate
Updates the specific estimate by setting the values of the parameters passed. Any parameters not provided will be left unchanged.
PATCH /v2/estimates/{ESTIMATE_ID} - Destructive
Delete an estimate
Delete an estimate.
DELETE /v2/estimates/{ESTIMATE_ID}
Expense Categories
- Read
List all expense categories
Returns a list of your expense categories. The expense categories are returned sorted by creation date, with the most recently created expense categories appearing first.
GET /v2/expense_categories - Read
Retrieve an expense category
Retrieves the expense category with the given ID.
GET /v2/expense_categories/{EXPENSE_CATEGORY_ID} - Write
Create an expense category
Creates a new expense category object.
POST /v2/expense_categories - Write
Update an expense category
Updates the specific expense category by setting the values of the parameters passed. Any parameters not provided will be left unchanged.
PATCH /v2/expense_categories/{EXPENSE_CATEGORY_ID} - Destructive
Delete an expense category
Delete an expense category.
DELETE /v2/expense_categories/{EXPENSE_CATEGORY_ID}
Expenses
- Read
List all expenses
Returns a list of your expenses. If accessing this endpoint as an Administrator, all expenses in the account will be returned.
GET /v2/expenses - Read
Retrieve an expense
Retrieves the expense with the given ID.
GET /v2/expenses/{EXPENSE_ID} - Write
Create an expense
Creates a new expense object.
POST /v2/expenses - Write
Update an expense
Updates the specific expense by setting the values of the parameters passed. Any parameters not provided will be left unchanged.
PATCH /v2/expenses/{EXPENSE_ID} - Write
Approve an expense
Approves a submitted expense, with the same effect as the Approvals page’s approve action. Approval applies to the expense’s submitter, project, and spent date, so matching time entries for that member, project, and day can change state with the expense.
POST /v2/expenses/{EXPENSE_ID}/approve - Write
Withdraw an expense
Withdraws an approved expense, returning it to submitted status, with the same effect as the Approvals page’s withdraw action. Withdrawal applies to the expense’s submitter, project, and spent date, so matching time entries for that member, project, and day can change state with the expense.
POST /v2/expenses/{EXPENSE_ID}/withdraw - Destructive
Delete an expense
Delete an expense.
DELETE /v2/expenses/{EXPENSE_ID}
Imports
- Read
List all imports
Returns the account’s recent import runs, newest first. The listing is limited to runs created in the last 30 days.
GET /v2/imports - Read
Retrieve an import
Retrieves the details of an existing import run.
GET /v2/imports/{IMPORT_ID} - Read
Download the CSV errors for an import
Downloads the rows that failed to import, as a text/csv file. The response has a Content-Disposition: attachment header.
GET /v2/imports/{IMPORT_ID}/csv_errors - Write
Create an import
The response includes a Location header with the URL of the created run.
POST /v2/imports - Write
Revert an import
Undoes a finished import by deleting the records it created.
POST /v2/imports/{IMPORT_ID}/revert
Gusto Settings and User Mappings
- Read
Retrieve Gusto settings
Returns the account’s Gusto settings object and a 200 OK response code.
GET /v2/integrations/gusto/settings - Write
Update Gusto settings
Updates the FLSA workweek anchor and the sync-reminder schedule.
PATCH /v2/integrations/gusto/settings - Write
Create a user mapping
Links a teammate to a Gusto person.
POST /v2/integrations/gusto/user_mappings - Write
Bulk create user mappings
Links several teammates to Gusto people in one request.
POST /v2/integrations/gusto/user_mappings/bulk_create - Destructive
Delete a user mapping
Unlinks a teammate from their Gusto person.
DELETE /v2/integrations/gusto/user_mappings/{USER_MAPPING_ID}
Gusto Sync Runs
- Read
Retrieve a sync run
Retrieves an existing sync run.
GET /v2/integrations/gusto/sync_runs/{SYNC_RUN_ID} - Write
Preview a sync run
Previews a time-sheet sync for a date range or a Gusto payroll.
POST /v2/integrations/gusto/sync_runs/preview - Write
Create a sync run
Creates and queues a time-sheet sync run for a date range or a Gusto payroll.
POST /v2/integrations/gusto/sync_runs
Invoice Item Categories
- Read
List all invoice item categories
Returns a list of your invoice item categories. The invoice item categories are returned sorted by creation date, with the most recently created invoice item categories appearing first.
GET /v2/invoice_item_categories - Read
Retrieve an invoice item category
Retrieves the invoice item category with the given ID.
GET /v2/invoice_item_categories/{INVOICE_ITEM_CATEGORY_ID} - Write
Create an invoice item category
Creates a new invoice item category object.
POST /v2/invoice_item_categories - Write
Update an invoice item category
Updates the specific invoice item category by setting the values of the parameters passed. Any parameters not provided will be left unchanged.
PATCH /v2/invoice_item_categories/{INVOICE_ITEM_CATEGORY_ID} - Destructive
Delete an invoice item category
Delete an invoice item category. Deleting an invoice item category is only possible if use_as_service and use_as_expense are both false.
DELETE /v2/invoice_item_categories/{INVOICE_ITEM_CATEGORY_ID}
Invoice Messages
- Read
List all messages for an invoice
Returns a list of messages associated with a given invoice. The invoice messages are returned sorted by creation date, with the most recently created messages appearing first.
GET /v2/invoices/{INVOICE_ID}/messages - Read
Retrieve invoice message subject and body for specific invoice
Does not create the invoice message.
GET /v2/invoices/{INVOICE_ID}/messages/new - Write
Create and send an invoice message
Creates a new invoice message object and sends it.
POST /v2/invoices/{INVOICE_ID}/messages - Destructive
Delete an invoice message
Delete an invoice message.
DELETE /v2/invoices/{INVOICE_ID}/messages/{message_ID}
Invoice Payments
- Read
List all payments for an invoice
Returns a list of payments associate with a given invoice. The payments are returned sorted by creation date, with the most recently created payments appearing first.
GET /v2/invoices/{INVOICE_ID}/payments - Write
Create an invoice payment
Creates a new invoice payment object.
POST /v2/invoices/{INVOICE_ID}/payments - Destructive
Delete an invoice payment
Delete an invoice payment.
DELETE /v2/invoices/{INVOICE_ID}/payments/{PAYMENT_ID}
Invoices
- Read
List all invoices
Returns a list of your invoices. The invoices are returned sorted by issue date, with the most recently issued invoices appearing first.
GET /v2/invoices - Read
Retrieve an invoice
Retrieves the invoice with the given ID.
GET /v2/invoices/{INVOICE_ID} - Read
Retrieve an e-invoice status
Retrieves the Peppol readiness and the latest submission status for an invoice.
GET /v2/invoices/{INVOICE_ID}/e_invoice_status - Write
Create a free-form invoice
Creates a new invoice object.
POST /v2/invoices - Write
Update an invoice
Updates the specific invoice by setting the values of the parameters passed. Any parameters not provided will be left unchanged.
PATCH /v2/invoices/{INVOICE_ID} - Write
Send an e-invoice
Sends an invoice over the Peppol network. The recipient’s Peppol identifier and the company’s legal-entity information are used, and the document is rendered for you.
POST /v2/invoices/{INVOICE_ID}/send_e_invoice - Destructive
Delete an invoice
Delete an invoice.
DELETE /v2/invoices/{INVOICE_ID}
Notification Preferences
- Read
Retrieve notification preferences
Returns the notification preferences for the authenticated user.
GET /v2/notification_preferences - Write
Update notification preferences
Updates the authenticated user’s notification preferences. Every key is optional, and omitted keys keep their current value.
PATCH /v2/notification_preferences - Write
Update notification preferences with PUT
Update notification preferences with PUT.
PUT /v2/notification_preferences
Notifications
- Read
List all notifications
Returns a list of the authenticated user’s notifications, newest first. The response contains an object with a notifications property that contains an array of up to per_page notifications.
GET /v2/notifications - Read
Retrieve the unread count
Returns the number of unread notifications for the authenticated user, with a breakdown by category. This endpoint takes no parameters.
GET /v2/notifications/unread_count - Read
Peek at notifications
Returns up to six of the authenticated user’s most recent notifications, along with the unread count. The response has no pagination envelope.
GET /v2/notifications/peek - Write
Mark a notification as read
Marks a single notification as read and returns the updated unread count. Reading an already-read notification returns the same count without changing the notification.
POST /v2/notifications/{NOTIFICATION_ID}/mark_read - Write
Mark all notifications as read
Marks all of the authenticated user’s unread notifications as read and returns the updated unread count. Calling this endpoint when there are no unread notifications returns the same count and is not an error.
POST /v2/notifications/mark_all_read
Projects
- Read
List all projects
Returns a list of your projects. The projects are returned sorted by creation date, with the most recently created projects appearing first.
GET /v2/projects - Read
Retrieve a project
Retrieves the project with the given ID.
GET /v2/projects/{PROJECT_ID} - Write
Create a project
Creates a new project object.
POST /v2/projects - Write
Update a project
Updates the specific project by setting the values of the parameters passed. Any parameters not provided will be left unchanged.
PATCH /v2/projects/{PROJECT_ID} - Destructive
Delete a project
Deletes a project and any time entries or expenses tracked to it. However, invoices associated with the project will not be deleted.
DELETE /v2/projects/{PROJECT_ID}
Tags
- Read
List all tags
Returns the tag vocabulary for the account. The tags are returned sorted by name, then by id.
GET /v2/tags
Project Task Assignments
- Read
List all task assignments
Returns a list of your task assignments. The task assignments are returned sorted by creation date, with the most recently created task assignments appearing first.
GET /v2/task_assignments - Read
List all task assignments for a specific project
Returns a list of your task assignments for the project identified by PROJECT_ID. The task assignments are returned sorted by creation date, with the most recently created task assignments appearing first.
GET /v2/projects/{PROJECT_ID}/task_assignments - Read
Retrieve a task assignment
Retrieves the task assignment with the given ID.
GET /v2/projects/{PROJECT_ID}/task_assignments/{TASK_ASSIGNMENT_ID} - Write
Create a task assignment
Creates a new task assignment object.
POST /v2/projects/{PROJECT_ID}/task_assignments - Write
Update a task assignment
Updates the specific task assignment by setting the values of the parameters passed. Any parameters not provided will be left unchanged.
PATCH /v2/projects/{PROJECT_ID}/task_assignments/{TASK_ASSIGNMENT_ID} - Destructive
Delete a task assignment
Delete a task assignment. Deleting a task assignment is only possible if it has no time entries associated with it.
DELETE /v2/projects/{PROJECT_ID}/task_assignments/{TASK_ASSIGNMENT_ID}
Project User Assignments
- Read
List all user assignments
Returns a list of your projects user assignments, active and archived. The user assignments are returned sorted by creation date, with the most recently created user assignments appearing first.
GET /v2/user_assignments - Read
List all user assignments for a specific project
Returns a list of user assignments for the project identified by PROJECT_ID. The user assignments are returned sorted by creation date, with the most recently created user assignments appearing first.
GET /v2/projects/{PROJECT_ID}/user_assignments - Read
Retrieve a user assignment
Retrieves the user assignment with the given ID.
GET /v2/projects/{PROJECT_ID}/user_assignments/{USER_ASSIGNMENT_ID} - Write
Create a user assignment
Creates a new user assignment object.
POST /v2/projects/{PROJECT_ID}/user_assignments - Write
Update a user assignment
Updates the specific user assignment by setting the values of the parameters passed. Any parameters not provided will be left unchanged.
PATCH /v2/projects/{PROJECT_ID}/user_assignments/{USER_ASSIGNMENT_ID} - Destructive
Delete a user assignment
Delete a user assignment. Deleting a user assignment is only possible if it has no time entries or expenses associated with it.
DELETE /v2/projects/{PROJECT_ID}/user_assignments/{USER_ASSIGNMENT_ID}
User Assignments & Allocations
- Read
List user assignments
Returns a list of users alongside their assigned holiday calendars, assigned work schedules, and effective working hours.
GET /v2/pto/assignments - Read
List user allocations
Returns a list of customized and yearly time off allocations across users. The response contains an object with a pto_allocations property that contains an array of up to per_page allocations.
GET /v2/pto/allocations - Write
Update user assignments
Assigns or unassigns a holiday calendar and work schedule for a specific user.
PATCH /v2/pto/assignments/{USER_ID} - Write
Update or reset a user allocation
Updates or resets per-user yearly allocation overrides.
PATCH /v2/pto/allocations - Write
Bulk update user allocations
Updates or resets per-user yearly allocation overrides for many users in one request. Each item can also assign that person’s holiday calendar.
PATCH /v2/pto/allocations/bulk
Holiday Calendars
- Read
List all holiday calendars
Returns a list of holiday calendars. The response contains an object with a pto_holiday_calendars property that contains an array of up to per_page holiday calendars.
GET /v2/pto/holiday_calendars - Read
Retrieve a holiday calendar
Retrieves the details of an existing holiday calendar.
GET /v2/pto/holiday_calendars/{HOLIDAY_CALENDAR_ID} - Read
List entries in a holiday calendar
Returns a list of holiday entries for the calendar identified by HOLIDAY_CALENDAR_ID. The response contains an object with a pto_holiday_calendar_entries property that contains an array of up to per_page entries.
GET /v2/pto/holiday_calendars/{HOLIDAY_CALENDAR_ID}/entries - Write
Create a holiday calendar
Creates a new holiday calendar.
POST /v2/pto/holiday_calendars - Write
Update a holiday calendar
Updates an existing holiday calendar.
PATCH /v2/pto/holiday_calendars/{HOLIDAY_CALENDAR_ID} - Write
Create an entry in a holiday calendar
Creates one or more holiday entries in a calendar. Supports a single date or a range of dates.
POST /v2/pto/holiday_calendars/{HOLIDAY_CALENDAR_ID}/entries - Write
Update a holiday calendar entry
Updates an existing holiday calendar entry.
PATCH /v2/pto/holiday_calendars/{HOLIDAY_CALENDAR_ID}/entries/{ENTRY_ID} - Destructive
Delete a holiday calendar
Deletes a holiday calendar.
DELETE /v2/pto/holiday_calendars/{HOLIDAY_CALENDAR_ID} - Destructive
Delete a holiday calendar entry
Deletes a holiday calendar entry.
DELETE /v2/pto/holiday_calendars/{HOLIDAY_CALENDAR_ID}/entries/{ENTRY_ID}
Time Off Balances
- Read
Retrieve time off balances
Returns time off balances broken down per policy for a specific user and year.
GET /v2/pto/balances
Time Off Policies
- Read
List all time off policies
Returns a list of time off policies. The response contains an object with a pto_types property that contains an array of up to per_page time off policies.
GET /v2/pto/types - Read
Retrieve a time off policy
Retrieves the details of an existing time off policy.
GET /v2/pto/types/{PTO_TYPE_ID} - Write
Create a time off policy
Creates a new time off policy.
POST /v2/pto/types - Write
Update a time off policy
Updates an existing time off policy.
PATCH /v2/pto/types/{PTO_TYPE_ID} - Destructive
Delete a time off policy
Deletes or deactivates an existing time off policy. By default, time off policies are deactivated rather than permanently deleted so historical requests and allocations remain preserved.
DELETE /v2/pto/types/{PTO_TYPE_ID}
Time Off Requests
- Read
List all time off requests
Returns a list of time off requests. The response contains an object with a pto_requests property that contains an array of up to per_page time off requests.
GET /v2/pto/requests - Read
Retrieve a time off request
Retrieves the details of an existing time off request.
GET /v2/pto/requests/{PTO_REQUEST_ID} - Write
Create a time off request
Creates a new time off request.
POST /v2/pto/requests - Write
Update a time off request
Updates an unreviewed time off request. Only pending or changes_requested requests can be edited.
PATCH /v2/pto/requests/{PTO_REQUEST_ID} - Write
Approve a time off request
Approves a pending or changes_requested request.
POST /v2/pto/requests/{PTO_REQUEST_ID}/approve - Write
Decline a time off request
Declines a time off request.
POST /v2/pto/requests/{PTO_REQUEST_ID}/decline - Write
Request changes on a time off request
Requests changes on a time off request.
POST /v2/pto/requests/{PTO_REQUEST_ID}/request_changes - Write
Approve multiple time off requests
Approves every pending request in the given set. Requests that are not pending — changes_requested or already decided — are not reviewed and are returned in skipped_ids.
POST /v2/pto/requests/approve - Write
Decline multiple time off requests
Declines every pending request in the given set. Requests that are not pending — changes_requested or already decided — are not reviewed and are returned in skipped_ids.
POST /v2/pto/requests/decline - Destructive
Cancel a time off request
Cancels a time off request. The request is not deleted from Harvest; instead, its status is updated to cancelled and it remains visible in request listings.
DELETE /v2/pto/requests/{PTO_REQUEST_ID}
Work Schedules
- Read
List all work schedules
Returns a list of work schedules. The response contains an object with a pto_work_schedules property that contains an array of up to per_page work schedules.
GET /v2/pto/work_schedules - Read
Retrieve a work schedule
Retrieves the details of an existing work schedule.
GET /v2/pto/work_schedules/{WORK_SCHEDULE_ID} - Write
Create a work schedule
Creates a new work schedule.
POST /v2/pto/work_schedules - Write
Update a work schedule
Updates an existing work schedule.
PATCH /v2/pto/work_schedules/{WORK_SCHEDULE_ID} - Destructive
Deactivate a work schedule
Deactivates a non-default work schedule.
DELETE /v2/pto/work_schedules/{WORK_SCHEDULE_ID}
Reimbursements
- Read
List all reimbursements
Returns a list of reimbursement requests, scoped to what the caller can see. The response contains an object with a reimbursements property that contains an array of up to per_page reimbursement objects.
GET /v2/reimbursements - Write
Reject a reimbursement
Rejects a reimbursement request.
POST /v2/reimbursements/{REIMBURSEMENT_ID}/reject - Write
Restore a reimbursement
Restores a rejected reimbursement request, clearing its rejection reason.
POST /v2/reimbursements/{REIMBURSEMENT_ID}/restore
Detailed Reports
- Read
Time Detailed Report
Returns the time detailed report for time tracked over a date range.
GET /v2/reports/time/detailed - Read
Expense Detailed Report
Returns the expense detailed report for expense tracked over a date range.
GET /v2/reports/expenses/detailed
Expense Reports
- Read
Clients Report
Returns the clients report for expense tracked over a date range.
GET /v2/reports/expenses/clients - Read
Projects Report
Returns the projects report for expense tracked over a date range.
GET /v2/reports/expenses/projects - Read
Expense Categories Report
Returns the expense categories report for expense tracked over a date range.
GET /v2/reports/expenses/categories - Read
Team Report
Returns the team report for expense tracked over a date range.
GET /v2/reports/expenses/team
Profitability Report
- Read
Profitability Report
Returns the profitability report over a date range.
GET /v2/reports/profitability
Project Budget Report
- Read
Project Budget Report
Returns the project budget report over a date range.
GET /v2/reports/project_budget
Report Exports
- Read
Retrieve a report export
Retrieves the status of an export.
GET /v2/reports/exports/{EXPORT_ID} - Read
Download a report export
Downloads the finished report export file.
GET /v2/reports/exports/{EXPORT_ID}/download - Write
Create a report export
Creates a report export.
POST /v2/reports/exports
Saved and Generated Reports
- Read
List all saved reports
Returns a list of saved reports, ordered by updated_at descending, then id descending. The response contains an object with a saved_reports property that contains an array of up to per_page saved report objects.
GET /v2/reports/saved - Read
Retrieve a saved report
Retrieves a saved report.
GET /v2/reports/saved/{SAVED_REPORT_ID} - Read
Run a saved report
Runs the stored definition of a saved report.
GET /v2/reports/generated/{SAVED_REPORT_ID} - Write
Create a saved report
Creates a saved report.
POST /v2/reports/saved - Write
Update a saved report
Updates a saved report.
PATCH /v2/reports/saved/{SAVED_REPORT_ID} - Write
Generate a report
Runs a report definition supplied in the request.
POST /v2/reports/generate - Destructive
Delete a saved report
Deletes a saved report.
DELETE /v2/reports/saved/{SAVED_REPORT_ID}
Time Reports
- Read
Clients Report
Returns the clients report for time tracked over a date range.
GET /v2/reports/time/clients - Read
Projects Report
Returns the projects report for time tracked over a date range.
GET /v2/reports/time/projects - Read
Tasks Report
Returns the tasks report for time tracked over a date range.
GET /v2/reports/time/tasks - Read
Team Report
Returns the team report for time tracked over a date range.
GET /v2/reports/time/team
Uninvoiced Report
- Read
Uninvoiced Report
Returns the uninvoiced report over a date range.
GET /v2/reports/uninvoiced
Custom Roles
- Read
List all custom roles
Returns a list of the account’s custom roles, sorted by descending ID. The response contains an object with a custom_roles property that contains an array of up to per_page custom roles.
GET /v2/custom_roles - Read
Retrieve a custom role
Retrieves the custom role with the given ID.
GET /v2/custom_roles/{CUSTOM_ROLE_ID} - Write
Create a custom role
Creates a custom role. An account can have a maximum of 50 custom roles.
POST /v2/custom_roles - Write
Update a custom role
Updates the custom role with the given ID by setting the values of the parameters passed. Any parameters not provided are left unchanged.
PATCH /v2/custom_roles/{CUSTOM_ROLE_ID} - Destructive
Delete a custom role
Deletes the custom role with the given ID.
DELETE /v2/custom_roles/{CUSTOM_ROLE_ID}
Permissions
- Read
List all permissions
Returns the account’s permission catalogue, sorted by ascending ID. The catalogue is the set of permissions the account can grant, and Forecast permissions are excluded.
GET /v2/permissions
Roles
- Read
List all roles
Returns a list of roles in the account. The roles are returned sorted by creation date, with the most recently created roles appearing first.
GET /v2/roles - Read
Retrieve a role
Retrieves the role with the given ID.
GET /v2/roles/{ROLE_ID} - Write
Create a role
Creates a new role object.
POST /v2/roles - Write
Update a role
Updates the specific role by setting the values of the parameters passed. Any parameters not provided will be left unchanged.
PATCH /v2/roles/{ROLE_ID} - Destructive
Delete a role
Delete a role. Deleting a role will unlink it from any users it was assigned to.
DELETE /v2/roles/{ROLE_ID}
Tasks
- Read
List all tasks
Returns a list of your tasks. The tasks are returned sorted by creation date, with the most recently created tasks appearing first.
GET /v2/tasks - Read
Retrieve a task
Retrieves the task with the given ID.
GET /v2/tasks/{TASK_ID} - Write
Create a task
Creates a new task object.
POST /v2/tasks - Write
Update a task
Updates the specific task by setting the values of the parameters passed. Any parameters not provided will be left unchanged.
PATCH /v2/tasks/{TASK_ID} - Destructive
Delete a task
Delete a task. Deleting a task is only possible if it has no time entries associated with it.
DELETE /v2/tasks/{TASK_ID}
Time Entries
- Read
List all time entries
Returns a list of time entries. The time entries are returned sorted by spent_date date.
GET /v2/time_entries - Read
Retrieve a time entry
Retrieves the time entry with the given ID.
GET /v2/time_entries/{TIME_ENTRY_ID} - Write
Create a time entry via duration
Creates a new time entry object.
POST /v2/time_entries - Write
Update a time entry
Updates the specific time entry by setting the values of the parameters passed. Any parameters not provided will be left unchanged.
PATCH /v2/time_entries/{TIME_ENTRY_ID} - Write
Restart a stopped time entry
Restarting a time entry is only possible if it isn’t currently running.
PATCH /v2/time_entries/{TIME_ENTRY_ID}/restart - Write
Stop a running time entry
Stopping a time entry is only possible if it’s currently running.
PATCH /v2/time_entries/{TIME_ENTRY_ID}/stop - Destructive
Delete a time entry’s external reference
Delete a time entry’s external reference.
DELETE /v2/time_entries/{TIME_ENTRY_ID}/external_reference - Destructive
Delete a time entry
Delete a time entry. Deleting a time entry is only possible if it’s not closed and the associated project and task haven’t been archived.
DELETE /v2/time_entries/{TIME_ENTRY_ID}
User Billable Rates
- Read
List all billable rates for a specific user
Returns a list of billable rates for the user identified by USER_ID. The billable rates are returned sorted by start_date, with the oldest starting billable rates appearing first.
GET /v2/users/{USER_ID}/billable_rates - Read
Retrieve a billable rate
Retrieves the billable rate with the given ID.
GET /v2/users/{USER_ID}/billable_rates/{billable_RATE_ID} - Write
Create a billable rate
Creates a new billable rate object.
POST /v2/users/{USER_ID}/billable_rates
User Cost Rates
- Read
List all cost rates for a specific user
Returns a list of cost rates for the user identified by USER_ID. The cost rates are returned sorted by start_date, with the oldest starting cost rates appearing first.
GET /v2/users/{USER_ID}/cost_rates - Read
Retrieve a cost rate
Retrieves the cost rate with the given ID.
GET /v2/users/{USER_ID}/cost_rates/{COST_RATE_ID} - Write
Create a cost rate
Creates a new cost rate object.
POST /v2/users/{USER_ID}/cost_rates
User Project Assignments
- Read
List active project assignments
Returns a list of active project assignments for the user identified by USER_ID. The project assignments are returned sorted by creation date, with the most recently created project assignments appearing first.
GET /v2/users/{USER_ID}/project_assignments - Read
List active project assignments for the currently authenticated user
Returns a list of your active project assignments for the currently authenticated user. The project assignments are returned sorted by creation date, with the most recently created project assignments appearing first.
GET /v2/users/me/project_assignments
User Teammates
- Read
List all assigned teammates for a specific user
Returns a list of assigned teammates for the user identified by USER_ID. The USER_ID must belong to a user that is a Manager, if not, a 422 Unprocessable Entity status code will be returned.
GET /v2/users/{USER_ID}/teammates - Write
Update a user’s assigned teammates
Updates the the assigned teammates for a specific user.
PATCH /v2/users/{USER_ID}/teammates
Users
- Read
List all users
Returns a list of your users. The users are returned sorted by creation date, with the most recently created users appearing first.
GET /v2/users - Read
Retrieve the currently authenticated user
Retrieves the currently authenticated user.
GET /v2/users/me - Read
Retrieve a user
Retrieves the user with the given ID.
GET /v2/users/{USER_ID} - Write
Create a user
Creates a new user object and sends an invitation email to the address specified in the email parameter.
POST /v2/users - Destructive
Update a user
Updates the specific user by setting the values of the parameters passed. Any parameters not provided will be left unchanged.
PATCH /v2/users/{USER_ID} - Destructive
Delete a user
Delete a user. Deleting a user is only possible if they have no time entries or expenses associated with them.
DELETE /v2/users/{USER_ID}
No operations match.
See How connections work for access and permissions, or browse all integrations.
Reference date: October 28, 2026. Harvest API docs.