start api message

Send, list, and delete messages in channels and threads

Requires authentication — run start login first or set START_API_KEY.

Commands

Command	Description
`start api message send`	Send a message to a channel or thread
`start api message list`	List recent messages in a channel with sender names and timestamps
`start api message delete`	Permanently delete a message by its ID

send

Send a message to a channel or thread

Terminal

start api message send <channel> <content>

Argument	Required	Description
`channel`	Yes	Channel ID to send the message to
`content`	Yes	Message text content

Flag	Type	Default	Description
`--thread`	string	—	Thread ID to reply in (sends as thread reply)
`--reply-to`	string	—	Message ID to reply to

list

List recent messages in a channel with sender names and timestamps

Terminal

start api message list <server> <channel>

Argument	Required	Description
`server`	Yes	Server ID
`channel`	Yes	Channel ID

Flag	Type	Default	Description
`--limit`	string	`20`	Maximum number of messages to return
`--json`	boolean	`false`	Output raw JSON (useful for piping to jq or scripts)

delete

Permanently delete a message by its ID

Terminal

start api message delete <id>

Argument	Required	Description
`id`	Yes	Message ID to delete

Examples

Send a message

Terminal

start api message send ch_abc123 "Hello from the CLI!"

✓ Message sent

Send a thread reply

Terminal

start api message send ch_abc123 "Thread reply" --thread thr_xyz789

List recent messages

Terminal

start api message list srv_abc123 ch_general

[10:30:15] Alice: Hey everyone!
[10:31:02] Bob: What's up?
[10:32:45] Alice: Working on the new feature

Get messages as JSON (for scripting)

Terminal

start api message list srv_abc123 ch_general --json | jq '.[0].content'

"Hey everyone!"

Delete a message

Terminal

start api message delete msg_abc123

✓ Message deleted

Pipe messages into another tool

Terminal

# export last 100 messages as JSON
start api message list srv_abc123 ch_general --limit 100 --json > messages.json

# count messages per user
start api message list srv_abc123 ch_general --json \
  | jq -r '.[].creator.name' | sort | uniq -c | sort -rn

app run

api channels