docs: API workspace agents and builds (#5538)

codersdk/workspaceapps.go

@@ -22,7 +22,7 @@ const (
 )
 
 type WorkspaceApp struct {
-	ID uuid.UUID `json:"id"`
+	ID uuid.UUID `json:"id" format:"uuid"`
 	// URL is the address being proxied to inside the workspace.
 	// If external is specified, this will be opened on the client.
 	URL string `json:"url"`
@@ -42,7 +42,7 @@ type WorkspaceApp struct {
 	// and there is no app wildcard configured on the server, the app will not
 	// be accessible in the UI.
 	Subdomain    bool                     `json:"subdomain"`
-	SharingLevel WorkspaceAppSharingLevel `json:"sharing_level"`
+	SharingLevel WorkspaceAppSharingLevel `json:"sharing_level" enums:"owner,authenticated,public"`
 	// Healthcheck specifies the configuration for checking app health.
 	Healthcheck Healthcheck        `json:"healthcheck"`
 	Health      WorkspaceAppHealth `json:"health"`