From 26ecc5e1f9330b8367abdc331fdd8aec74826120 Mon Sep 17 00:00:00 2001
From: Quentin Rousseau <879780+kwent@users.noreply.github.com>
Date: Wed, 4 Nov 2026 21:21:48 +0000
Subject: [PATCH 1/2] [AC1][AC2][AC3][AC4] docs: document incident association
 flags on create/update (docs only; flags shipped in #55)

Co-authored-by: soil-cloud[bot] <344511034+soil-cloud[bot]@users.noreply.github.com>
---
 README.md | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/README.md b/README.md
index e8c9854..895cb68 100644
--- a/README.md
+++ b/README.md
@@ -90,6 +90,9 @@ rootly incidents create --title="API degradation" --field="customer_impact=Check
 rootly incidents update <id> --status=mitigated
 rootly incidents update <id> --scheduled-until=2025-06-20T13:00:00Z
 rootly incidents update <id> --field="customer_impact=Checkout restored"
+rootly incidents create --title="Checkout errors" --services=api-gateway,payments --types=customer-impacting
+rootly incidents update INC-123 --services=api-gateway --teams=platform
+rootly incidents update INC-123 --types=                # Clears the incident types
 rootly incidents delete <id>
 
 # Alerts
@@ -161,6 +164,26 @@ rootly incidents create --title="Release" \
   --field="regions=EU West"
 ```
 
+### Incident Associations
+
+`incidents create` and `incidents update` can link an incident to other Rootly records. Each flag takes comma-separated slugs or IDs, like `rootly pulse --services`:
+
+| Flag | Links | API attribute |
+|------|-------|---------------|
+| `--services` | Services | `service_ids` |
+| `--types` | Incident types | `incident_type_ids` |
+| `--functionalities` | Functionalities | `functionality_ids` |
+| `--environments` | Environments | `environment_ids` |
+| `--teams` | Teams | `group_ids` |
+| `--causes` | Causes | `cause_ids` |
+
+On `update`, only the flags you pass are sent. Each one replaces the incident's current list, and an empty value (`--services=`) clears it. `update` accepts a sequential ID such as `INC-123` as well as a UUID or slug.
+
+```bash
+rootly incidents create --title="Checkout errors" --services=api-gateway,payments --types=customer-impacting
+rootly incidents update INC-123 --services=api-gateway --teams=platform
+```
+
 ### Status-Page Templates and Maintenance Statuses
 
 List a status page's templates with `rootly status-pages templates list --status-page=<id>`. The command supports `--page`, `--page-size`, and the standard `--format` output flag.

From 0839c603dbed69d4d425c9b766e06f6fee6cb11a Mon Sep 17 00:00:00 2001
From: Quentin Rousseau <879780+kwent@users.noreply.github.com>
Date: Wed, 4 Nov 2026 21:26:31 +0000
Subject: [PATCH 2/2] docs: reference rootly pulse create --services in
 incident associations

Co-authored-by: soil-cloud[bot] <344511034+soil-cloud[bot]@users.noreply.github.com>
---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 895cb68..78eb727 100644
--- a/README.md
+++ b/README.md
@@ -166,7 +166,7 @@ rootly incidents create --title="Release" \
 
 ### Incident Associations
 
-`incidents create` and `incidents update` can link an incident to other Rootly records. Each flag takes comma-separated slugs or IDs, like `rootly pulse --services`:
+`incidents create` and `incidents update` can link an incident to other Rootly records. Each flag takes comma-separated slugs or IDs, like `rootly pulse create --services`:
 
 | Flag | Links | API attribute |
 |------|-------|---------------|