v1

latestOpenAPI 3.1.0AGPL-3.0 license2026-07-1210336283.6 KB

Tracker Entries

Create a tracker entry

Create a tracker entry for the authenticated team.

post/tracker-entries

Request body

startstring date-time required

Start time of the tracker entry in ISO 8601 format

stopstring date-time required

Stop time of the tracker entry in ISO 8601 format

datesstring[] required

Array of dates for which to create tracker entries

assignedIdstring uuid nullable

Unique identifier of the user assigned to this tracker entry. If not provided, will use the authenticated user

projectIdstring uuid required

Unique identifier of the project associated with this tracker entry

descriptionstring nullable

Optional description or notes for the tracker entry

durationnumber required

Duration of the tracker entry in seconds

Example request

{
  "start": "2024-04-15T09:00:00.000Z",
  "stop": "2024-04-15T17:00:00.000Z",
  "dates": [
    "2024-04-15",
    "2024-04-16"
  ],
  "assignedId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "projectId": "b3b6e2c2-1f2a-4e3b-9c1d-2a4b6e2c21f2",
  "description": "Worked on implementing user authentication feature",
  "duration": 28800
}

Response

Tracker entry created successfully.

Example response

{
  "data": [
    {
      "id": "b3b6e2c2-1f2a-4e3b-9c1d-2a4b6e2c21f2",
      "createdAt": "2024-04-15T09:00:00.000Z",
      "duration": 28800,
      "start": "2024-04-15T09:00:00.000Z",
      "stop": "2024-04-15T17:00:00.000Z",
      "teamId": "team-1234",
      "description": "Worked on implementing user authentication feature",
      "rate": 75,
      "currency": "USD",
      "date": "2024-04-15",
      "user": {
        "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "fullName": "Jane Doe",
        "avatarUrl": "https://cdn.midday.ai/avatar.jpg"
      },
      "project": {
        "id": "b3b6e2c2-1f2a-4e3b-9c1d-2a4b6e2c21f2",
        "createdAt": "2024-03-01T10:00:00.000Z",
        "rate": 75,
        "currency": "USD",
        "status": "in_progress",
        "description": "Complete website redesign with modern UI/UX",
        "name": "Website Redesign Project",
        "billable": true,
        "estimate": 120,
        "customer": {
          "id": "customer-1234",
          "name": "Acme Corporation"
        }
      }
    }
  ]
}