chore: move common methods to examples, sort alphabetically

Author: mwbrooks

cmd/api/api.go

@@ -68,35 +68,28 @@ func NewCommand(clients *shared.ClientFactory) *cobra.Command {
 			"  5. Interactive prompt        Select from stored workspaces (CLI tooling token)",
 			"",
 			"See all methods at: https://docs.slack.dev/reference/methods",
-			"",
-			"Common methods:",
-			"  api.test                        Test your API connection",
-			"  auth.test                       Check authentication",
-			"  chat.postMessage                Send a message to a channel",
-			"  chat.update                     Update a message",
-			"  chat.delete                     Delete a message",
-			"  conversations.list              List channels",
-			"  conversations.history           Fetch messages from a channel",
-			"  conversations.info              Get channel details",
-			"  conversations.members           List members in a channel",
-			"  conversations.create            Create a channel",
-			"  users.list                      List workspace members",
-			"  users.info                      Get user details",
-			"  files.upload                    Upload a file",
-			"  reactions.add                   Add an emoji reaction",
-			"  reactions.list                  List reactions for a user",
-			"  bookmarks.add                   Add a bookmark to a channel",
-			"  pins.add                        Pin a message",
-			"  views.open                      Open a modal view",
-			"  views.update                    Update a modal view",
 		}, "\n"),
 		Example: style.ExampleCommandsf([]style.ExampleCommand{
-			{Command: "api auth.test", Meaning: "Test authentication with the current workspace"},
-			{Command: "api chat.postMessage channel=C0123456 text=\"Hello\"", Meaning: "Post a message"},
-			{Command: "api users.list --team myworkspace", Meaning: "List users in a specific workspace"},
-			{Command: `api chat.postMessage --json '{"channel":"C0123456","text":"Hello"}'`, Meaning: "Send a JSON body"},
-			{Command: "api auth.test --include", Meaning: "Show HTTP status and response headers"},
-			{Command: "api conversations.history -X GET channel=C0123456", Meaning: "Use GET method"},
+			{Command: "api api.test", Meaning: "Test your API connection"},
+			{Command: "api auth.test", Meaning: "Check authentication"},
+			{Command: "api bookmarks.add channel_id=C0123456 title=Docs link=https://example.com", Meaning: "Add a bookmark to a channel"},
+			{Command: "api chat.postMessage channel=C0123456 text=\"Hello\"", Meaning: "Send a message to a channel using form-encoded string"},
+			{Command: `api chat.postMessage --json '{"channel":"C0123456","text":"Hello"}'`, Meaning: "Send a message to a channel using JSON"},
+			{Command: "api chat.update channel=C0123456 ts=1234567890.123456 text=\"Updated\"", Meaning: "Update a message"},
+			{Command: "api conversations.create name=new-channel", Meaning: "Create a channel"},
+			{Command: "api conversations.history channel=C0123456", Meaning: "Fetch messages from a channel"},
+			{Command: "api conversations.info channel=C0123456", Meaning: "Get channel details"},
+			{Command: "api conversations.list", Meaning: "List channels"},
+			{Command: "api conversations.members channel=C0123456", Meaning: "List members in a channel"},
+			{Command: "api files.upload channels=C0123456 filename=report.csv", Meaning: "Upload a file"},
+			{Command: "api pins.add channel=C0123456 timestamp=1234567890.123456", Meaning: "Pin a message"},
+			{Command: "api reactions.add channel=C0123456 timestamp=1234567890.123456 name=thumbsup", Meaning: "Add an emoji reaction"},
+			{Command: "api reactions.list user=U0123456", Meaning: "List reactions for a user"},
+			{Command: "api users.info user=U0123456", Meaning: "Get user details"},
+			{Command: "api users.list", Meaning: "List workspace members"},
+			{Command: "api users.profile.get user=U0123456", Meaning: "Get a user's profile"},
+			{Command: "api views.open trigger_id=T0123456 view={...}", Meaning: "Open a modal view"},
+			{Command: "api views.update view_id=V0123456 view={...}", Meaning: "Update a modal view"},
 		}),
 		Args: cobra.MinimumNArgs(1),
 		PreRunE: func(cmd *cobra.Command, args []string) error {