> ## Documentation Index
> Fetch the complete documentation index at: https://ekso.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# DataTime

> Sample shape for DataTime.

Sample shape for `DataTime`.

## Sample JSON

Copy, edit, paste. Server-set fields (`id`, `created`, `tenantId`, …) are omitted from the example — they're populated by the server on response.

```json theme={null}
{
  "dated": "2026-04-29T14:30:00Z",
  "userId": "<user_id>",
  "nonBillableId": "<non-billable_id>",
  "timeLogged": "example",
  "comment": "example"
}
```

## Fields

| Field           | Type               | Required     | Notes                                   |
| --------------- | ------------------ | ------------ | --------------------------------------- |
| `entity`        | string • nullable  | Server-set   | Set by the server. Read-only on writes. |
| `dated`         | string (date-time) | Optional     |                                         |
| `userId`        | string             | **Required** |                                         |
| `nonBillableId` | string             | **Required** |                                         |
| `timeLogged`    | string             | **Required** |                                         |
| `comment`       | string             | Optional     |                                         |
| `tenantId`      | string             | Server-set   | Set by the server. Read-only on writes. |
| `id`            | string             | Server-set   | Set by the server. Read-only on writes. |
| `created`       | string (date-time) | Server-set   | Set by the server. Read-only on writes. |
| `createdBy`     | string             | Server-set   | Set by the server. Read-only on writes. |
| `updated`       | string (date-time) | Server-set   | Set by the server. Read-only on writes. |
| `updatedBy`     | string             | Server-set   | Set by the server. Read-only on writes. |
| `deleted`       | boolean            | Server-set   | Set by the server. Read-only on writes. |

## Used by

### Request body

* `POST /api/time`
* `PUT /api/time/{id}`

### Response body

* `POST /api/time/{id}`
* `POST /api/time`
* `PUT /api/time/{id}`

### CLI

`ekso time` — see the [command branches](/cli/branches) page for available verbs. Body for create / update verbs typically passed via `--data @file.json` matching the [sample JSON](#sample-json) above.