# Statuses and Users

Statuses and users are reference data. Use them to resolve IDs before task updates, assignment-related payloads, filtering, or reporting.

## Statuses

List statuses:

```bash
toggl --json statuses list
```

Use this before moving a task when the user gives a status name instead of a status ID:

```bash
toggl --json tasks update --task-id <task-id> --payload-status-id <status-id>
```

## Users

List users:

```bash
toggl --json users list
```

Use this before working with assignee/member IDs when a user gives a person name or email.

## Agent Workflow

Do not guess IDs from names. List the reference data, pick the exact match, and ask when there are multiple plausible matches.

If a status or user appears missing, verify the active workspace and profile before concluding it does not exist.