# pw billing allocations usage post

> Source: https://parallelworks.com/docs/cli/pw/billing/allocations/usage/post

## pw billing allocations usage post

Record a usage event against an allocation

```
pw billing allocations usage post <allocation> [flags]
```

### Examples

```
  # 64 core-hours of CPU usage in a time window
  pw billing allocations usage post --sku SLURM_CPU_HOUR --quantity 64 \
  --start 2026-06-23T10:00:00Z --end 2026-06-23T14:00:00Z \
  --metadata jobId=12345 --metadata cluster=hpc1 research-team
```

### Options

```
      --end string             End time (RFC3339)
  -h, --help                   help for post
      --metadata stringArray   Repeatable key=value metadata
      --org string             Target organization (defaults to current context)
  -o, --output string          Output format (table, json) (default "table")
      --quantity float         Quantity of usage
      --sku string             SKU code to attribute usage to
      --start string           Start time (RFC3339, e.g. 2026-06-23T10:00:00Z)
      --user string            Attribute usage to this user (org admins only)
```

### Options inherited from parent commands

```
      --context string         The context to use. Overrides PW_CONTEXT environment variable and current context from config.
      --platform-host string   The Parallel Works ACTIVATE platform host to use. Will override any other platform host settings.
  -v, --verbose                Enable verbose logging
```

### SEE ALSO

* [pw billing allocations usage](/docs/cli/pw/billing/allocations/usage)	 - Post and list usage events for an allocation