Time tracking – build on Flowtly

Use this curated snapshot of the Flowtly OpenAPI schema to plan integrations, automate workflows, and sync the data your teams rely on.

Documentation status

Last synced on 2024-07-08 12:00 (app version 2.0.0)

Only a subset of entities is made public. Run both sync commands to refresh this documentation when the Flowtly app ships new capabilities.

Time tracking

Sync work logs from PM tools into Flowtly.

Entity overview

Work time

Use WorkTime entries to drive utilization, payroll, and invoicing dashboards without forcing teams to re-enter hours.

Endpoints

GET /api/employee_working_hours

List work logs

Read employee_working_hours collections filtered by employee, project, or time range.

POST /api/employee_working_hours

Create work log

Push a new work-time entry with seconds, description, and references to employees/projects.

GET /api/employee_working_hours/{id}

Get work log by ID

Inspect a single recorded work-time entry.

PATCH /api/employee_working_hours/{id}

Update work log

Patch logged seconds, project, or notes when corrections are needed.

GET /api/employee-working-hours

List employee-working-hours

Retrieve employee-working-hours with pagination and filters.

POST /api/employee-working-hours

Create employee-working-hour

Create a new employee-working-hour entry.

GET /api/employee-working-hours/{id}

Get employee-working-hour

Fetch a single employee-working-hour by ID.

PATCH /api/employee-working-hours/{id}

Update employee-working-hour

Patch fields of an employee-working-hour entry.

DELETE /api/employee-working-hours/{id}

Delete employee-working-hour

Remove an employee-working-hour entry.

GET /api/work-times

List work-times

Retrieve work-time entries.

POST /api/work-times

Create work-time

Create a work-time record.

GET /api/work-times/{id}

Get work-time

Fetch a single work-time by ID.

PATCH /api/work-times/{id}

Update work-time

Patch a work-time record.

DELETE /api/work-times/{id}

Delete work-time

Delete a work-time record.

GET /api/employees/{id}/working-hours-stats/{date}

Get working-hours stats

Retrieve aggregated working-hours stats for an employee at a date.

Use cases

Ingest retro-approved hours from Asana so PMO dashboards inside Flowtly stay current.
Send billable hours from an agency’s task board to Flowtly to generate invoices automatically.

Schema fields

WorkTime
Field Type Description
id integer Internal identifier of the work log.
employee string Employee IRI that submitted the time.
project string Project IRI receiving the work.
date string Timestamp indicating when the work occurred.
seconds integer Duration recorded in seconds.
description string | null Optional note describing the activity.
createdAt string When the entry was created in Flowtly.
updatedAt string When the entry was last modified.
deletedAt string | null Timestamp of soft deletion, if any.
deleted boolean Check if the entity has been soft deleted.

Examples

POST /api/employee_working_hours

Push a billable work log from Asana

Pushes a 7.5-hour (27,000-second) log from your PM tool so Flowtly can update utilization and invoicing metrics.

Request payload 
{
    "employee": "/api/employees/emp_102",
    "project": "/api/projects/aurora",
    "date": "2024-07-04T00:00:00+00:00",
    "seconds": 27000,
    "description": "Budget review for Aurora project"
}
Response payload 
{
    "@id": "/api/employee_working_hours/wkt_9001",
    "@type": "WorkTime",
    "id": 9001,
    "employee": "/api/employees/emp_102",
    "project": "/api/projects/aurora",
    "date": "2024-07-04T00:00:00+00:00",
    "seconds": 27000,
    "description": "Budget review for Aurora project",
    "createdAt": "2024-07-04T18:05:00+00:00",
    "updatedAt": "2024-07-04T18:05:00+00:00",
    "deleted": false
}
Whatsapp