timer-tracking

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['project', 'start'], 'properties': {'end': {'type': 'string', 'description': 'ISO 8601 end time (or use minutes)'}, 'note': {'type': 'string', 'description': 'Optional note'}, 'rate': {'anyOf': [{'type': 'number', 'minimum': 0}, {'type': 'string'}], 'description': "Hourly rate for this entry; a number (90) or the words the user said ('90 euros an hour')"}, 'tags': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Optional tags'}, 'task': {'type': 'string', 'description': 'What the work was'}, 'start': {'type': 'string', 'description': 'ISO 8601 start time, e.g. 2026-09-02T09:00:00'}, 'minutes': {'type': 'number', 'description': 'Duration in minutes (alternative to end)', 'exclusiveMinimum': 0}, 'project': {'type': 'string', 'minLength': 1, 'description': 'Project or client name. A partial name that matches exactly one existing project is used as that project.'}, 'billable': {'type': 'boolean', 'description': 'Default true; set false for non-billable work'}, 'currency': {'type': 'string', 'description': "Currency of the rate: EUR, USD, GBP, PLN, or words like 'euros'. Defaults to the project currency, else USD."}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'Entry id from entry_list'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'Entry id from entry_list'}, 'end': {'type': 'string', 'description': 'ISO 8601'}, 'note': {'type': 'string'}, 'rate': {'anyOf': [{'type': 'number', 'minimum': 0}, {'type': 'string'}], 'description': "Hourly rate override for this entry, a number or words like '90 euros'"}, 'tags': {'type': 'array', 'items': {'type': 'string'}}, 'task': {'type': 'string'}, 'start': {'type': 'string', 'description': 'ISO 8601'}, 'minutes': {'type': 'number', 'description': 'New duration in minutes, keeps start', 'exclusiveMinimum': 0}, 'project': {'type': 'string'}, 'billable': {'type': 'boolean'}, 'currency': {'type': 'string', 'description': 'Currency of the rate, e.g. EUR'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'to': {'type': 'string', 'description': 'ISO date/time upper bound'}, 'from': {'type': 'string', 'description': 'ISO date/time lower bound'}, 'limit': {'type': 'integer', 'description': 'Maximum rows, newest first (default 50)', 'exclusiveMinimum': 0}, 'project': {'type': 'string', 'description': 'Filter by project name'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['invoice_number'], 'properties': {'to': {'type': 'string', 'description': 'ISO date/time end of the billed period, used with project'}, 'ids': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Exact entry ids, normally the entry_ids invoice_summary returned. Pass either ids or project plus from and to. Entries already billed are left alone and listed back to you.'}, 'from': {'type': 'string', 'description': 'ISO date/time start of the billed period, used with project'}, 'project': {'type': 'string', 'description': 'Project or client, used with from and to instead of ids; every billable entry in that range is stamped.'}, 'billed_at': {'type': 'string', 'description': 'ISO timestamp of the stamp, defaults to now'}, 'invoice_number': {'type': 'string', 'minLength': 1, 'description': 'The invoice these hours were put on, e.g. INV-2026-0001'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'to': {'type': 'string', 'description': 'ISO date/time upper bound. On the free tier the export is clamped to the last 7 days; Pro exports the full history.'}, 'from': {'type': 'string', 'description': 'ISO date/time lower bound. On the free tier the export is clamped to the last 7 days; Pro exports the full history.'}, 'path': {'type': 'string', 'description': 'Target file path; a relative path resolves against the working directory. Defaults to a timestamped file in the local data directory, and the full path is returned.'}, 'project': {'type': 'string', 'description': 'Optional project filter'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['project', 'from', 'to'], 'properties': {'to': {'type': 'string', 'description': 'ISO date/time end of the billing period. Free covers the last 7 days; Pro invoices any period from the full history.'}, 'from': {'type': 'string', 'description': 'ISO date/time start of the billing period. Free covers the last 7 days; Pro invoices any period from the full history.'}, 'project': {'type': 'string', 'minLength': 1, 'description': 'Project or client to invoice'}, 'unbilled_only': {'type': 'boolean', 'description': 'Default true: hours already put on an invoice (entry_mark_billed) are left out, so the same hours are never billed twice. Pass false to see the whole period including invoiced work.'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['key'], 'properties': {'key': {'type': 'string', 'description': 'License key from checkout, MCPL1.<payload>.<signature>'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['project', 'hourly_rate'], 'properties': {'project': {'type': 'string', 'minLength': 1, 'description': 'Project or client name. A partial name that matches exactly one existing project is used as that project.'}, 'currency': {'type': 'string', 'description': "Currency: a code (EUR, USD, GBP, PLN) or a word ('euros', 'pounds', 'zl'). Defaults to the shared business profile's default_currency, else USD."}, 'hourly_rate': {'anyOf': [{'type': 'number', 'minimum': 0}, {'type': 'string'}], 'description': "Hourly rate: a number (85) or the words the user said ('90 euros an hour'). '1,200 USD' is 1200; '12,50 EUR' is 12.50; anything ambiguous is refused."}, 'only_missing': {'type': 'boolean', 'description': 'Only meaningful with apply_to_existing. True restores the old fill-the-gaps behaviour: only entries that carry no rate of their own are touched. Default false, which re-stamps every entry of the project.'}, 'apply_to_existing': {'type': 'boolean', 'description': 'Re-rate time already logged for this project: every entry is re-stamped with the new rate, including entries that already carry one. Default false: the new rate applies to future entries only, because each entry captures the rate in force when it was logged.'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['from', 'to'], 'properties': {'to': {'type': 'string', 'description': 'ISO date/time end of the period. On the free tier the window is clamped to the last 7 days; Pro reports over the full history.'}, 'from': {'type': 'string', 'description': 'ISO date/time start of the period. On the free tier the window is clamped to the last 7 days; Pro reports over the full history.'}, 'format': {'enum': ['table', 'json', 'csv'], 'type': 'string', 'description': 'table (default), json or csv. Every format carries one amount per currency, never a mixed-currency sum.'}, 'project': {'type': 'string', 'description': 'Optional project filter'}, 'group_by': {'enum': ['project', 'day', 'task', 'tag'], 'type': 'string', 'description': 'project | day | task | tag. Optional: omit it for the plain total per currency, with no breakdown. Money is grouped by currency and EUR is never added to USD.'}, 'unbilled_only': {'type': 'boolean', 'description': "Default true: hours already put on an invoice (entry_mark_billed) are excluded, so the report answers 'what is still to bill'. Pass false for the full timesheet including invoiced work."}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['project'], 'properties': {'rate': {'anyOf': [{'type': 'number', 'minimum': 0}, {'type': 'string'}], 'description': "Hourly rate for this timer only; a number (90) or the words the user said, e.g. rate '90 euros an hour'. Defaults to the project rate set by project_set_rate."}, 'tags': {'type': 'array', 'items': {'type': 'string'}, 'description': "Free-form tags, e.g. ['dev','meeting']"}, 'task': {'type': 'string', 'description': 'What you are working on right now'}, 'project': {'type': 'string', 'minLength': 1, 'description': "Project or client name, e.g. 'acme-website'. A partial name that matches exactly one existing project is used as that project."}, 'currency': {'type': 'string', 'description': "Currency of the rate: EUR, USD, GBP, PLN, or words like 'euros'. Defaults to the project currency, else USD."}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'note': {'type': 'string', 'description': 'Optional note stored with the entry'}}, 'additionalProperties': False}