> For the complete documentation index, see [llms.txt](https://docs.january.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.january.ai/mobile-sdks/readme/food-logs.md).

# Food logs

Use `client.foodLogs` to create, list, update, and delete entries for a partner-owned user.

## Build user context

Food-log operations require an end-user ID. Provide an IANA timezone when available.

```swift
let user = FoodLogUserContext(
    endUserID: PartnerUserID(rawValue: userID),
    timezone: "America/New_York"
)
```

## Select a food and serving

Use identifiers returned by food or menu search:

```swift
let selectedFood = FoodSelection(
    id: food.id,
    serving: ServingSelection(
        id: serving.id,
        quantity: 1
    )
)
```

## Create

```swift
let log = try await client.foodLogs.create(
    .init(
        foods: [selectedFood],
        timestampUTC: ISO8601DateFormatter().string(from: Date()),
        name: "Breakfast",
        user: user
    )
)
```

## List

Dates use `yyyy-MM-dd`:

```swift
let logs = try await client.foodLogs.list(
    .init(
        start: "2026-08-01",
        end: "2026-08-31",
        user: user
    )
)
```

## Update

Only fields supplied in the request are changed.

```swift
let updated = try await client.foodLogs.update(
    .init(id: log.id, name: "Post-workout breakfast", user: user)
)
```

## Delete

```swift
let result = try await client.foodLogs.delete(
    .init(id: log.id, user: user)
)
```