Allow all tags to be reset in one operation?

[garethsb]

Should it be possible to remove/reset to default all tags on a resource in one request?

PATCH /self

{
  "tags": null
}

This would need to succeed even when the resource has one or more read-only tags and leave them unchanged. This begs the question about whether a request like the following should succeed (and leave the value(s) unchanged) or fail?

PATCH /self

{
  "tags": {
    "read-only-tag": null
  }
}

Thoughts?

---

FWIW, I think it's clear that a request to actually change the value(s) associated with a read-only tag must fail with 500 response.

PATCH /self

{
  "tags": {
    "read-only-tag": [...]
  }
}

Compare behaviour with read/write tags...

1. Replace the value(s)

   PATCH /self

   {
    "tags": {
      "read-write-tag": [...]
    }
   }

2. Remove the tag or reset to its default/underlying value(s)

   PATCH /self

   {
    "tags": {
      "read-write-tag": null
    }
   }

[garethsb]

This has the advantage of making a sensible looking "reset all request":

{
    "description": null,
    "label": null,
    "tags": null
}