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

# agentlinkops lifecycle

> Read and update placement deal metadata, retain due renewal notices or report cost by currency.

```bash theme={null}
agentlinkops lifecycle get|update|clear WATCH_ID [--revision N] [--deal PATCH.json] [--decimal-cost] | renew [--limit N] | report [--from DATE] [--to DATE]
```

## Behavior and output

Uses the connected project and scoped cloud credential. Updates require the observed revision. JSON patches preserve omitted fields and clear explicit nulls. costMinor and currency travel together. The explicit decimal adapter reads cost\_amount strings and cost\_currency using declared currency scales; it rejects fractional minor units. No payment or message is sent.

## Arguments

\--deal names a bounded JSON patch file. --decimal-cost explicitly converts legacy decimal cost fields. --revision is required for update and clear. Dates use YYYY-MM-DD.

## Exit status

0 on success; 2 on usage, configuration, input or request failure.

Read [configuration and file ownership](/reference/local/configuration) before automating this command. Read [local file contracts](/reference/local/artifacts) for artifact fields. Browse the [local command index](/reference/local/index) for related commands.

<Note>Check the selected environment and workspace access before calling hosted operations. See [capability status](/capability-status).</Note>