Card time logs
A finished entry of time that a person spent on a card, in minutes, for example 180 minutes on 2026-01-21. Each entry names a user and the day of work. The entry is logged under the built-in role Employee. The time of a stopped timer is recorded here as a finished entry; timers that are still running are not imported. Without author_ref the user whose time it is counts as the author.
A record of this entity needs records of other entities in the package: Cards; Users.
Files in the package
List every file of this entity in resource_files of the manifest, with "resource": "card_time_logs". An entity can have any number of files. See Bundle format.
[
{
"resource": "card_time_logs",
"path": "resources/card_time_logs.json"
}
]Fields
| Field | Type | Required | Description |
|---|---|---|---|
external_id | string (ExternalId) | Yes | Your own identifier of the record, for example k-mrr, unique within the resource across all of its files and case sensitive. Other records refer to this one by it.Constraints: 1–512 characters. |
card_ref | Ref<cards> refers to Cards | Yes | The card the time was spent on. Give the external_id of a cards record. |
for_date | LocalDate | Yes | The day the work was done, YYYY-MM-DD.Constraints: YYYY-MM-DD. |
time_spent | integer | Yes | Time spent, in whole minutes, at least 1. For example 180 is three hours. Constraints: >= 1. |
user_ref | Ref<users> refers to Users | Yes | The person whose time is logged. Give the external_id of a users record. |
author_ref | Ref<users>? refers to Users | No | The user who entered the record; it defaults to user_ref. Give the external_id of a users record.Default: |
comment | string? | No | A note about the work, up to 32767 characters. Constraints: at most 32767 characters. |
created_at | Timestamp | No | When the record was created, with a time zone, for example 2026-01-12T09:30:00Z.Constraints: RFC 3339 with a time zone. Default: |
References
Show on the entity map
Example
A record of this entity:
{
"external_id": "tl-liam-mrr",
"card_ref": "k-mrr",
"user_ref": "u-liam",
"time_spent": 180,
"for_date": "2026-01-21",
"comment": "Wrote the first definition.",
"created_at": "2026-01-21T17:00:00Z"
}Related entities
Cards, Users
Check after the import
After the import, the records of this entity can be checked on Card time logs › Get time logs and Timesheet › Get list.
JSON Schema
card_time_logs.json
