feat: show devcontainer dirty status and allow recreate (#17880)

Updates #16424

docs/reference/api/agents.md

@@ -776,6 +776,7 @@ curl -X GET http://coder-server:8080/api/v2/workspaceagents/{workspaceagent}/con
   "containers": [
     {
       "created_at": "2019-08-24T14:15:22Z",
+      "devcontainer_dirty": true,
       "id": "string",
       "image": "string",
       "labels": {
@@ -813,6 +814,33 @@ curl -X GET http://coder-server:8080/api/v2/workspaceagents/{workspaceagent}/con
 
 To perform this operation, you must be authenticated. [Learn more](authentication.md).
 
+## Recreate devcontainer for workspace agent
+
+### Code samples
+
+```shell
+# Example request using curl
+curl -X POST http://coder-server:8080/api/v2/workspaceagents/{workspaceagent}/containers/devcontainers/container/{container}/recreate \
+  -H 'Coder-Session-Token: API_KEY'
+```
+
+`POST /workspaceagents/{workspaceagent}/containers/devcontainers/container/{container}/recreate`
+
+### Parameters
+
+| Name             | In   | Type         | Required | Description          |
+|------------------|------|--------------|----------|----------------------|
+| `workspaceagent` | path | string(uuid) | true     | Workspace agent ID   |
+| `container`      | path | string       | true     | Container ID or name |
+
+### Responses
+
+| Status | Meaning                                                         | Description | Schema |
+|--------|-----------------------------------------------------------------|-------------|--------|
+| 204    | [No Content](https://tools.ietf.org/html/rfc7231#section-6.3.5) | No Content  |        |
+
+To perform this operation, you must be authenticated. [Learn more](authentication.md).
+
 ## Coordinate workspace agent
 
 ### Code samples