diff --git a/coderd/apidoc/docs.go b/coderd/apidoc/docs.go index fd369b9097..a76b7e1c59 100644 --- a/coderd/apidoc/docs.go +++ b/coderd/apidoc/docs.go @@ -28687,7 +28687,17 @@ const docTemplate = `{ "name": "Coder-Session-Token", "in": "header" } - } + }, + "tags": [ + { + "description": "Workspace agent endpoints. These power the workspace agent daemon defined by the ` + "`" + `coder_agent` + "`" + ` Terraform resource. This API is NOT the Coder Agents Chats API. For programmatic access to AI Coder Agents, see the Chats API.", + "name": "Agents" + }, + { + "description": "Programmatic API for Coder Agents (the user-facing \"Coder Agents\" / \"Chats\" product). Use these endpoints to create, list, and manage AI coding agent sessions.", + "name": "Chats" + } + ] }` // SwaggerInfo holds exported Swagger Info so clients can modify it diff --git a/coderd/apidoc/swagger.json b/coderd/apidoc/swagger.json index 32bfbd4754..7af7ee8340 100644 --- a/coderd/apidoc/swagger.json +++ b/coderd/apidoc/swagger.json @@ -26471,5 +26471,15 @@ "name": "Coder-Session-Token", "in": "header" } - } + }, + "tags": [ + { + "description": "Workspace agent endpoints. These power the workspace agent daemon defined by the `coder_agent` Terraform resource. This API is NOT the Coder Agents Chats API. For programmatic access to AI Coder Agents, see the Chats API.", + "name": "Agents" + }, + { + "description": "Programmatic API for Coder Agents (the user-facing \"Coder Agents\" / \"Chats\" product). Use these endpoints to create, list, and manage AI coding agent sessions.", + "name": "Chats" + } + ] } diff --git a/coderd/coderd.go b/coderd/coderd.go index 601669d321..e45055aab1 100644 --- a/coderd/coderd.go +++ b/coderd/coderd.go @@ -325,6 +325,12 @@ type Options struct { // @BasePath / +// @tag.name Agents +// @tag.description Workspace agent endpoints. These power the workspace agent daemon defined by the `coder_agent` Terraform resource. This API is NOT the Coder Agents Chats API. For programmatic access to AI Coder Agents, see the Chats API. + +// @tag.name Chats +// @tag.description Programmatic API for Coder Agents (the user-facing "Coder Agents" / "Chats" product). Use these endpoints to create, list, and manage AI coding agent sessions. + // @securitydefinitions.apiKey Authorization // @in header // @name Authorizaiton diff --git a/docs/manifest.json b/docs/manifest.json index b679fed7fa..8504b4fa10 100644 --- a/docs/manifest.json +++ b/docs/manifest.json @@ -1530,6 +1530,7 @@ }, { "title": "Agents", + "description": "REST endpoints for the workspace agent daemon (`coder_agent`).", "path": "./reference/api/agents.md" }, { @@ -1554,6 +1555,7 @@ }, { "title": "Chats", + "description": "REST endpoints for Coder Agents Chats API (programmatic agent sessions).", "path": "./reference/api/chats.md", "state": ["early access"] }, diff --git a/docs/reference/api/agents.md b/docs/reference/api/agents.md index de826c6615..61271500a2 100644 --- a/docs/reference/api/agents.md +++ b/docs/reference/api/agents.md @@ -1,5 +1,7 @@ # Agents +Workspace agent endpoints. These power the workspace agent daemon defined by the `coder_agent` Terraform resource. This API is NOT the Coder Agents Chats API. For programmatic access to AI Coder Agents, see the Chats API. + ## Get DERP map updates ### Code samples diff --git a/docs/reference/api/chats.md b/docs/reference/api/chats.md index f3597c4462..76bb91445c 100644 --- a/docs/reference/api/chats.md +++ b/docs/reference/api/chats.md @@ -1,5 +1,7 @@ # Chats +Programmatic API for Coder Agents (the user-facing "Coder Agents" / "Chats" product). Use these endpoints to create, list, and manage AI coding agent sessions. + ## List chats ### Code samples