moves/ docs

Available tools

The 35 tools available to connected assistants, with required permissions.

llms.txt

Moves

ToolPermissionWhat it does
moves_homemoves:readRead your open move, ideas, and bounded feed of moves shared with you.
move_getmoves:readRead a visible live move by moveId; unavailable moves return null.
move_createmoves:writeShare an open move or idea with a chosen audience.
move_updatemoves:writeEdit your live move's title or timing.
move_endmoves:writeEnd your move and remove it from live feeds.
move_set_interestmoves:writeSet or withdraw your interest in a move shared with you.

Creating an open move ends your previous open move; you can have up to five live ideas. Choose now, tonight, or weekend, or use later for an idea with dates. expiresAt is a future Unix timestamp in milliseconds, chosen for the user's intended time and timezone. Later dates use { kind: "month" | "dates", startDate, endDate } with YYYY-MM-DD strings. The backend validates the date range and expiry. title is text up to 80 characters or null. Updates leave omitted fields unchanged; null clears a title. Changing timing may also require changing expiresAt.

Audiences are friends, friendsOfFriends, or selected. For selected, pass selectedUserIds from your mutual friends. To share with a crew, read its memberIds and pass them as selectedUserIds; crewId alone only updates recency. The audience is fixed when a move is created, and editing a crew does not change it.

Interest is private: only the move's author sees who responded. Other viewers see the count and their own response. Interest can notify the author and is not an RSVP or a commitment to attend.

Friends and activity

ToolPermissionWhat it does
friends_listconnections:readList mutual friends and their user IDs.
connections_incomingconnections:readList people waiting for you to add them back.
connections_listconnections:readRead incoming, outgoing, and mutual relationship states.
connection_addconnections:writeAdd a known user; becomes a friendship if they already added you.
connection_removeconnections:writeRemove your connection and its friendship access.
activity_getactivity:readRead incoming adds and private interest in your live moves, up to 50 each.

Adding someone may notify them. Removing a friendship also removes each person from the other's live move audiences, interests, and crews. The tools do not upload contacts or search arbitrary phone numbers.

Private crews

ToolPermissionWhat it does
crews_listcrews:readList your crews and current friend member IDs, most recently used first.
crew_createcrews:writeCreate a crew with at least one mutual friend.
crew_updatecrews:writeEdit a crew's name, color, emoji, or member list.
crew_set_membershipcrews:writePut one friend in exactly the specified crews you own.
crew_removecrews:writeDelete your crew without removing friendships.

Crews are private audience shortcuts, not shared groups. Creation takes name, color (blue, pink, or yellow), emoji (text or null), and memberIds. Updating memberIds replaces the entire list; omitted fields stay unchanged. For crew_set_membership, an empty crewIds array removes the person from all your crews. Crew changes do not notify members or alter existing move audiences.

Connection invites

These tools invite people to become friends. They do not invite someone to attend a move.

ToolPermissionWhat it does
invite_createinvites:writeCreate an invite and return its private token once.
invite_previewinvites:readPreview an invite by token without accepting it.
invites_listinvites:readList your active invites; tokens are not recoverable.
invite_requestsinvites:readList claims and applicants for an invite you own.
invite_acceptinvites:writeAccept a named invite or request approval for an open invite.
invite_cancelinvites:writeCancel your pending claim.
invite_decideinvites:writeApprove or decline a claim on your invite.
invite_revokeinvites:writeStop further acceptance or approval of your invite.

invite_create accepts optional recipientId, maxUses (1–20, default 1), and ttlSeconds (60–604,800, default 604,800 / seven days). Named recipients require one use and can accept directly; open invites need the creator's approval. Acceptance or approval can create mutual friendship and notifications. Treat the returned token as a private bearer secret and share it only with intended recipients.

Repeating acceptance returns the existing claim; it never restores a removed friendship. Cancelling marks a pending claim declined, and accepting the same invite again does not resubmit it. Decisions cannot change an already decided claim. Revoking an invite does not remove existing friendships.

Example requests

  • “Who's open tonight?” — moves:read.
  • “Share a coffee idea with my Weekend crew.” — crews:read and moves:write.
  • “Show who's interested in my moves.” — activity:read.
  • “Create a one-hour connection invite for one person.” — invites:write.

Confirm the intended audience and timing before sharing. After an uncertain create result, inspect moves, crews, or invites before retrying: creating again can duplicate records. An invite's raw token cannot be recovered from its list.

Profile settings

These tools work with your private settings. They do not manage other people's profiles or delete your Moves account.

ToolPermissionWhat it does
profile_getprofile:readRead your settings; returns null if none exist.
profile_createprofile:writeCreate settings; fails if they already exist.
profile_updateprofile:writeChange existing settings. Omitted fields stay unchanged; null clears text.
profile_removeprofile:writeDelete your settings, not your account.

Feedback

Assistants can only access feedback that belongs to your account.

ToolPermissionWhat it does
feedback_getfeedback:readRead one entry by ID; returns null if unavailable.
feedback_listfeedback:readList your feedback, newest first.
feedback_createfeedback:writeSend a message of 1–5,000 characters. Category defaults to other.
feedback_updatefeedback:writeChange a message or category by ID.
feedback_removefeedback:writePermanently delete an entry by ID.

For feedback_list, request 1–100 items with paginationOpts. Start with cursor: null; use the returned continueCursor until isDone is true.

List the first ten feedback entries
{
  "paginationOpts": {
    "numItems": 10,
    "cursor": null
  }
}

If sending feedback times out, check your feedback list before trying again. A repeated create request can create another entry.

Current screen

ToolPermissionWhat it does
get_current_contextcontext:readRead a snapshot from the source you selected for this assistant.

The snapshot includes its update and expiry times. It can be null if you have not selected a source, the source expires, sharing stops, or the session ends. An assistant should ask what you mean when no context is available.

Tool discovery

Your assistant discovers the current argument schemas directly from the server. Tool visibility does not grant access: every call checks the connection, permission, and ownership. If a tool needs more access, your assistant must request it through a new consent flow.

On this page