Skip to Content
DevelopersAPI referenceTime

Create time favorite

POST
/v1/time-favorites

Authorization

apiKey
headerAuthorizationBearer <token>

An API key (blk_…) from Settings → API keys.

Request Body

application/json
  1. body
description?|
Lengthlength <= 500
projectId?|
Match^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
Formatuuid
taskId?|
Match^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
Formatuuid
tagIds?array<>
Itemsitems <= 20
billable?boolean|null

Response Body

application/json
  1. response
id*string
description*string|null
projectId*string|null
projectName*string|null
clientName*string|null
taskId*string|null
taskTitle*string|null
tags*array<>
billable*boolean|null
Example Request
curl -X POST 'https://your-billleaf-api/v1/time-favorites' \  -H 'Content-Type: application/json' \  -d '{}'
Example Response201
{  "id": "string",  "description": "string",  "projectId": "string",  "projectName": "string",  "clientName": "string",  "taskId": "string",  "taskTitle": "string",  "tags": [    {      "id": "string",      "name": "string",      "color": "gray"    }  ],  "billable": true}