Time Entry

A tracked interval of work on a task.

Whose entries you see depends on your role. By default list, get and search return only your own entries. If your role holds viewTimeReports, list and get return every entry in your team, and memberId narrows that to one person — this is how a team-wide time report is built.

Note for integrations: breadth follows the ROLE, not the token. A token granted time-entry read by someone holding viewTimeReports can read that whole team, not only the person who granted it.

search is the exception: it stays scoped to your own entries whatever your role, so it under-reports a team. Use list for reporting.

Omit end (or send null) to start a running entry, then PATCH end to stop it. taskId and projectId are set once: an entry cannot be moved to another task or project afterwards.

List Time Entries

GET

https://openapi.niftypm.com/api/v3

/time-entries

Bearer (nft_user_* (personal access token) or nft_oauth_* (OAuth 2.1 access token))

OAuth 2.0

List timeEntries. Returns a paginated envelope (data, total, limit, hasMore, nextCursor). Filterable by 5 fields. Ordered by start unless you pass sort. Returns your own entries by default. With viewTimeReports on your role it returns every entry in your team instead; filter memberId for one person. This is the endpoint to build a team time report from — search stays scoped to your own entries regardless of role.

Required scope: time-entries:read

List Time Entries › query Parameters

sort

string · enum

Field to sort by. Prefix with - for descending (-createdAt); a createdAt:desc / createdAt:asc suffix works too, but never both markers at once. Default: start.

Enum values:

start

createdAt

-start

-createdAt

cursor

string

Opaque cursor for the next page (the envelope nextCursor).

limit

integer · min: 1 · max: 200

Items per page (1–200, default 50). A larger value is clamped to the cap rather than rejected, so always follow nextCursor instead of assuming one page held everything.

Default: 50

includeTotal

boolean

When true, the response envelope includes the total number of matching rows. Omit it for cheaper pagination.

expand

string[] · style: form

Comma-separated relations to inline (see Expanding objects above). Valid values are listed in the enum.

Enum values:

member

manual[eq]

boolean

Filter where manual equals.

start[gt]

string · date-time

Filter where start is greater than.

start[gte]

string · date-time

Filter where start is greater than or equal to.

start[lt]

string · date-time

Filter where start is less than.

start[lte]

string · date-time

Filter where start is less than or equal to.

projectId[eq]

string

Filter where projectId equals.

projectId[in]

string[] · style: form

Filter where projectId is one of (comma-separated list).

taskId[eq]

string

Filter where taskId equals.

taskId[in]

string[] · style: form

Filter where taskId is one of (comma-separated list).

memberId[eq]

string

Filter where memberId equals.

memberId[in]

string[] · style: form

Filter where memberId is one of (comma-separated list).

List Time Entries › Responses

Cursor-paginated collection envelope.

timeEntryExpanded[] · required

The page of results.

total

integer

Total rows matching the query (across pages).

limit

integer

hasMore

boolean

nextCursor

string | null

Opaque cursor for the next page; null on the last page.

GET/time-entries

curl "https://openapi.niftypm.com/api/v3/time-entries" \
  -H "Authorization: Bearer $NIFTY_TOKEN"

Example Responses

{
  "data": [
    {
      "id": "sfmueIsa",
      "createdAt": "2026-05-31T12:00:00.000Z",
      "updatedAt": "2026-05-31T14:00:00.000Z",
      "description": "A concise description.",
      "start": "2026-06-01T12:00:00.000Z",
      "end": "2026-06-14T12:00:00.000Z",
      "manual": false,
      "projectId": "iV6vIU8N",
      "memberId": "P3hYIKqK",
      "taskId": "KfS0ha8P"
    },
    {
      "id": "czeMwGCa",
      "createdAt": "2026-05-31T12:00:00.000Z",
      "updatedAt": "2026-05-31T14:00:00.000Z",
      "description": "A concise description.",
      "start": "2026-06-01T12:00:00.000Z",
      "end": "2026-06-14T12:00:00.000Z",
      "manual": false,
      "projectId": "iV6vIU8N",
      "memberId": "P3hYIKqK",
      "taskId": "KfS0ha8P"
    }
  ],
  "total": 5,
  "limit": 2,
  "hasMore": true,
  "nextCursor": "b2NjdXJyZWRBdD0yMDI2LTA1LTMxVDEyOjAwOjAwWg"
}

json

application/json

Create Time Entry

POST

https://openapi.niftypm.com/api/v3

/time-entries

Bearer (nft_user_* (personal access token) or nft_oauth_* (OAuth 2.1 access token))

OAuth 2.0

Create a Time Entry. Server-assigned fields are ignored if sent.

Required scope: time-entries:write

Create Time Entry › query Parameters

expand

string[] · style: form

Comma-separated relations to inline (see Expanding objects above). Valid values are listed in the enum.

Enum values:

member

Create Time Entry › Headers

Idempotency-Key

string · maxLength: 250

Optional replay key (see Idempotent requests above).

Create Time Entry › Request Body

timeEntryCreate

start

string · date-time · required

When the tracked interval began (ISO 8601).

Example: 2026-06-01T12:00:00.000Z

taskId

string · minLength: 1 · required

The task this time is tracked against. Set once when the entry is created: an entry cannot be moved to another task afterwards.

Example: KfS0ha8P

description

string | null

Free-text note about what the time was spent on. This is the field GET /time-entries/search matches against.

Example: A concise description.

end

string | null · date-time

When the tracked interval ended (ISO 8601). Omit it, or send null, to create a running entry; PATCH end to stop it.

Example: 2026-06-14T12:00:00.000Z

projectId

string | null

The project this time is booked against. Set once when the entry is created: an entry cannot be moved to another project afterwards.

Example: iV6vIU8N

Create Time Entry › Responses

Created

A Time Entry with its `?expand=` relations inlined.

timeEntryExpanded

id

string · minLength: 1 · readOnly · required

Unique identifier for this resource.

Example: sfmueIsa

createdAt

string · date-time · readOnly · required

Creation timestamp.

Example: 2026-05-31T12:00:00.000Z

start

string · date-time · required

When the tracked interval began (ISO 8601).

Example: 2026-06-01T12:00:00.000Z

manual

boolean · readOnly · required

True for entries created through this API; false for entries captured by the timer in the Nifty app. Server-set.

Example: false

memberId

string · minLength: 1 · readOnly · required

The team member this time is tracked for. Set by the server from whoever is calling — you cannot log time on someone else's behalf.

Example: P3hYIKqK

taskId

string · minLength: 1 · required

The task this time is tracked against. Set once when the entry is created: an entry cannot be moved to another task afterwards.

Example: KfS0ha8P

updatedAt

string | null · date-time · readOnly

Last update timestamp.

Example: 2026-05-31T14:00:00.000Z

description

string | null

Free-text note about what the time was spent on. This is the field GET /time-entries/search matches against.

Example: A concise description.

end

string | null · date-time

When the tracked interval ended (ISO 8601). Omit it, or send null, to create a running entry; PATCH end to stop it.

Example: 2026-06-14T12:00:00.000Z

projectId

string | null

The project this time is booked against. Set once when the entry is created: an entry cannot be moved to another project afterwards.

Example: iV6vIU8N

object

The related Team Member, present only when you pass ?expand=member.

POST/time-entries

curl -X POST "https://openapi.niftypm.com/api/v3/time-entries" \
  -H "Authorization: Bearer $NIFTY_TOKEN" \
  -H "Idempotency-Key: 3f0b1c8a-9f0e-4a2f-8f5e-2b7c9d1e4a60" \
  -H "Content-Type: application/json" \
  -d '{"description":"A concise description.","start":"2026-06-01T12:00:00.000Z","end":"2026-06-14T12:00:00.000Z","projectId":"iV6vIU8N","taskId":"KfS0ha8P"}'

Example Request Body

{
  "description": "A concise description.",
  "start": "2026-06-01T12:00:00.000Z",
  "end": "2026-06-14T12:00:00.000Z",
  "projectId": "iV6vIU8N",
  "taskId": "KfS0ha8P"
}

json

application/json

Example Responses

{
  "id": "sfmueIsa",
  "createdAt": "2026-05-31T12:00:00.000Z",
  "updatedAt": "2026-05-31T14:00:00.000Z",
  "description": "A concise description.",
  "start": "2026-06-01T12:00:00.000Z",
  "end": "2026-06-14T12:00:00.000Z",
  "manual": false,
  "projectId": "iV6vIU8N",
  "memberId": "P3hYIKqK",
  "taskId": "KfS0ha8P"
}

json

application/json

Get Time Entry

GET

https://openapi.niftypm.com/api/v3

/time-entries/{id}

Bearer (nft_user_* (personal access token) or nft_oauth_* (OAuth 2.1 access token))

OAuth 2.0

Retrieve a single Time Entry by id. By default only your own entries are reachable here. With viewTimeReports on your role, so is any entry in your team — get widens exactly as list does, so a row you can see in list is a row you can fetch by id. Without that permission another member's entry is 404, not 403.

Required scope: time-entries:read

Get Time Entry › path Parameters

id

string · minLength: 1 · pattern: ^[0-9A-Za-z_!]+$ · required

Id of the Time Entry.

Get Time Entry › query Parameters

expand

string[] · style: form

Comma-separated relations to inline (see Expanding objects above). Valid values are listed in the enum.

Enum values:

member

Get Time Entry › Responses

A Time Entry with its `?expand=` relations inlined.

timeEntryExpanded

id

string · minLength: 1 · readOnly · required

Unique identifier for this resource.

Example: sfmueIsa

createdAt

string · date-time · readOnly · required

Creation timestamp.

Example: 2026-05-31T12:00:00.000Z

start

string · date-time · required

When the tracked interval began (ISO 8601).

Example: 2026-06-01T12:00:00.000Z

manual

boolean · readOnly · required

True for entries created through this API; false for entries captured by the timer in the Nifty app. Server-set.

Example: false

memberId

string · minLength: 1 · readOnly · required

The team member this time is tracked for. Set by the server from whoever is calling — you cannot log time on someone else's behalf.

Example: P3hYIKqK

taskId

string · minLength: 1 · required

The task this time is tracked against. Set once when the entry is created: an entry cannot be moved to another task afterwards.

Example: KfS0ha8P

updatedAt

string | null · date-time · readOnly

Last update timestamp.

Example: 2026-05-31T14:00:00.000Z

description

string | null

Free-text note about what the time was spent on. This is the field GET /time-entries/search matches against.

Example: A concise description.

end

string | null · date-time

When the tracked interval ended (ISO 8601). Omit it, or send null, to create a running entry; PATCH end to stop it.

Example: 2026-06-14T12:00:00.000Z

projectId

string | null

The project this time is booked against. Set once when the entry is created: an entry cannot be moved to another project afterwards.

Example: iV6vIU8N

object

The related Team Member, present only when you pass ?expand=member.

Delete Time Entry

DELETE

https://openapi.niftypm.com/api/v3

/time-entries/{id}

Bearer (nft_user_* (personal access token) or nft_oauth_* (OAuth 2.1 access token))

OAuth 2.0

Permanently delete this Time Entry. This cannot be undone.

Required scope: time-entries:delete

Delete Time Entry › path Parameters

id

string · minLength: 1 · pattern: ^[0-9A-Za-z_!]+$ · required

Id of the Time Entry.

Delete Time Entry › Headers

Idempotency-Key

string · maxLength: 250

Optional replay key (see Idempotent requests above).

Delete Time Entry › Responses

No Content

No data returned

Update Time Entry

PATCH

https://openapi.niftypm.com/api/v3

/time-entries/{id}

Bearer (nft_user_* (personal access token) or nft_oauth_* (OAuth 2.1 access token))

OAuth 2.0

Partially update a Time Entry. Only the fields you send are changed.

Required scope: time-entries:write

Update Time Entry › path Parameters

id

string · minLength: 1 · pattern: ^[0-9A-Za-z_!]+$ · required

Id of the Time Entry.

Update Time Entry › query Parameters

expand

string[] · style: form

Comma-separated relations to inline (see Expanding objects above). Valid values are listed in the enum.

Enum values:

member

Update Time Entry › Headers

Idempotency-Key

string · maxLength: 250

Optional replay key (see Idempotent requests above).

Update Time Entry › Request Body

timeEntryUpdate

description

string | null

Free-text note about what the time was spent on. This is the field GET /time-entries/search matches against.

Example: A concise description.

start

string · date-time

When the tracked interval began (ISO 8601).

Example: 2026-06-01T12:00:00.000Z

end

string | null · date-time

When the tracked interval ended (ISO 8601). Omit it, or send null, to create a running entry; PATCH end to stop it.

Example: 2026-06-14T12:00:00.000Z

expectedUpdatedAt

string · date-time

Optional concurrency guard: the updatedAt you last read. If the resource has changed since, the update is rejected with 409 instead of overwriting the other writer. Re-read, re-derive your change from the current values, and retry with the fresh updatedAt.

Example: 2026-05-31T12:00:00.000Z

Update Time Entry › Responses

A Time Entry with its `?expand=` relations inlined.

timeEntryExpanded

id

string · minLength: 1 · readOnly · required

Unique identifier for this resource.

Example: sfmueIsa

createdAt

string · date-time · readOnly · required

Creation timestamp.

Example: 2026-05-31T12:00:00.000Z

start

string · date-time · required

When the tracked interval began (ISO 8601).

Example: 2026-06-01T12:00:00.000Z

manual

boolean · readOnly · required

True for entries created through this API; false for entries captured by the timer in the Nifty app. Server-set.

Example: false

memberId

string · minLength: 1 · readOnly · required

The team member this time is tracked for. Set by the server from whoever is calling — you cannot log time on someone else's behalf.

Example: P3hYIKqK

taskId

string · minLength: 1 · required

The task this time is tracked against. Set once when the entry is created: an entry cannot be moved to another task afterwards.

Example: KfS0ha8P

updatedAt

string | null · date-time · readOnly

Last update timestamp.

Example: 2026-05-31T14:00:00.000Z

description

string | null

Free-text note about what the time was spent on. This is the field GET /time-entries/search matches against.

Example: A concise description.

end

string | null · date-time

When the tracked interval ended (ISO 8601). Omit it, or send null, to create a running entry; PATCH end to stop it.

Example: 2026-06-14T12:00:00.000Z

projectId

string | null

The project this time is booked against. Set once when the entry is created: an entry cannot be moved to another project afterwards.

Example: iV6vIU8N

object

The related Team Member, present only when you pass ?expand=member.

PATCH/time-entries/{id}

curl -X PATCH "https://openapi.niftypm.com/api/v3/time-entries/sfmueIsa" \
  -H "Authorization: Bearer $NIFTY_TOKEN" \
  -H "Idempotency-Key: 3f0b1c8a-9f0e-4a2f-8f5e-2b7c9d1e4a60" \
  -H "Content-Type: application/json" \
  -d '{"description":"A concise description.","start":"2026-06-01T12:00:00.000Z","end":"2026-06-14T12:00:00.000Z","expectedUpdatedAt":"2026-05-31T12:00:00.000Z"}'

Example Request Body

{
  "description": "A concise description.",
  "start": "2026-06-01T12:00:00.000Z",
  "end": "2026-06-14T12:00:00.000Z",
  "expectedUpdatedAt": "2026-05-31T12:00:00.000Z"
}

json

application/json

Example Responses

{
  "id": "sfmueIsa",
  "createdAt": "2026-05-31T12:00:00.000Z",
  "updatedAt": "2026-05-31T14:00:00.000Z",
  "description": "A concise description.",
  "start": "2026-06-01T12:00:00.000Z",
  "end": "2026-06-14T12:00:00.000Z",
  "manual": false,
  "projectId": "iV6vIU8N",
  "memberId": "P3hYIKqK",
  "taskId": "KfS0ha8P"
}

json

application/json

Search Time Entries

GET

https://openapi.niftypm.com/api/v3

/time-entries/search

Bearer (nft_user_* (personal access token) or nft_oauth_* (OAuth 2.1 access token))

OAuth 2.0

Full-text ranked search across timeEntries. Ranked by relevance; pages are capped at 200 results. Filterable by 5 fields. Always scoped to your own entries, whatever your role — unlike list and get, a reporting permission does NOT widen it. Do not build a team report from this endpoint; it will silently under-report.

Required scope: time-entries:read

Search Time Entries › query Parameters

q

string · minLength: 3 · maxLength: 200 · required

Full-text search query. Trimmed before matching; URLs, e-mail addresses and HTML markup are rejected.

cursor

string

Opaque cursor for the next page (the envelope nextCursor).

limit

integer · min: 1 · max: 200

Items per page (1–200, default 50). A larger value is clamped to the cap rather than rejected, so always follow nextCursor instead of assuming one page held everything.

Default: 50

includeTotal

boolean

When true, the response envelope includes the total number of matching rows. Omit it for cheaper pagination.

expand

string[] · style: form

Comma-separated relations to inline (see Expanding objects above). Valid values are listed in the enum.

Enum values:

member

manual[eq]

boolean

Filter where manual equals.

start[gt]

string · date-time

Filter where start is greater than.

start[gte]

string · date-time

Filter where start is greater than or equal to.

start[lt]

string · date-time

Filter where start is less than.

start[lte]

string · date-time

Filter where start is less than or equal to.

projectId[eq]

string

Filter where projectId equals.

projectId[in]

string[] · style: form

Filter where projectId is one of (comma-separated list).

taskId[eq]

string

Filter where taskId equals.

taskId[in]

string[] · style: form

Filter where taskId is one of (comma-separated list).

memberId[eq]

string

Filter where memberId equals.

memberId[in]

string[] · style: form

Filter where memberId is one of (comma-separated list).

Search Time Entries › Responses

Cursor-paginated collection envelope.

timeEntryExpanded[] · required

The page of results.

total

integer

Total rows matching the query (across pages).

limit

integer

hasMore

boolean

nextCursor

string | null

Opaque cursor for the next page; null on the last page.

GET/time-entries/search

curl "https://openapi.niftypm.com/api/v3/time-entries/search?q=design" \
  -H "Authorization: Bearer $NIFTY_TOKEN"

Example Responses

{
  "data": [
    {
      "id": "sfmueIsa",
      "createdAt": "2026-05-31T12:00:00.000Z",
      "updatedAt": "2026-05-31T14:00:00.000Z",
      "description": "A concise description.",
      "start": "2026-06-01T12:00:00.000Z",
      "end": "2026-06-14T12:00:00.000Z",
      "manual": false,
      "projectId": "iV6vIU8N",
      "memberId": "P3hYIKqK",
      "taskId": "KfS0ha8P"
    },
    {
      "id": "czeMwGCa",
      "createdAt": "2026-05-31T12:00:00.000Z",
      "updatedAt": "2026-05-31T14:00:00.000Z",
      "description": "A concise description.",
      "start": "2026-06-01T12:00:00.000Z",
      "end": "2026-06-14T12:00:00.000Z",
      "manual": false,
      "projectId": "iV6vIU8N",
      "memberId": "P3hYIKqK",
      "taskId": "KfS0ha8P"
    }
  ],
  "total": 5,
  "limit": 2,
  "hasMore": true,
  "nextCursor": "b2NjdXJyZWRBdD0yMDI2LTA1LTMxVDEyOjAwOjAwWg"
}

json

application/json

Recurring Rule Project

Was this page helpful?