AI agents for Mattermost

Who am I

Reads the account the token belongs to: id (needed for create_direct_channel), username, first_name, last_name, nickname, email, roles and timezone.

List my teams

Lists the teams the account belongs to: each with id (for list_channels and search_posts), name (the URL name), display_name, description and type (O open, I invite only).

List my channels in a team

Lists every channel of a team the account is a member of: each with id (for create_post and list_posts), name, display_name, type.

Find a channel by name

Finds a channel by its team's URL name and its own URL name (the parts of its address: /acme/channels/town-square is team acme, channel town-square).

Read a channel's posts

Reads a page of a channel's posts, newest first: order[] holds post IDs in order and posts maps each ID to its post.

Read a thread

Reads a post and every reply in its thread: order[] (post IDs) and posts (each post's message, user_id, create_at).

Search posts

Searches a team's posts the account can see.

Find a person by username

Reads a user by username (without the @): id (for create_direct_channel), username, first_name, last_name, nickname, email (if the server shows it) and locale.

Post a message

Posts a message (Markdown allowed, up to 16,383 characters) to a channel or direct-message channel as the token's user or bot.

Open a direct message

Opens (or returns the existing) direct-message channel between the account (my_user_id, from get_me) and another user (user_id, from get_user_by_username).