Skip to main content
POST
Create a time entry (idempotent)

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

team_id
string
required

Team ID is an alphanumerical string that identifies a Team. This is externally referred to as a "Workspace".

Body

application/json

Time entry to create.

id
string
required

Client-supplied ULID. Repeating the same id makes the call idempotent.

Example:

"01HQK6Z9YJZ4M9JX8FVB6QXYAB"

scope_type
enum<string>
required

Scope a time entry attaches to. card ties the entry to a specific card (and rolls up to its epic), while category ties the entry to a workspace-level time category not associated with any card.

Available options:
card,
category
Example:

"card"

scope_id
string
required
Example:

"2700"

started_at
integer<int64>
required

unix timestamp in seconds

Example:

1608742037016

duration_seconds
integer<int64>
required
Example:

1800

description
string | null
Example:

"Pairing with Alex on the API spec"

billable
boolean | null

Defaults to the category default (or workspace default) when omitted.

Response

Existing time entry returned (idempotent replay)

time_entry
object