Misskey
App · 20 actions
Post to Misskey from a workflow, on any server. Publish notes with files and polls, renote and react, read timelines, hashtags and notifications, search, and follow accounts.
Actions
| Action | What it does |
|---|---|
| Add reaction | React to a note with an emoji. |
| Create note | Publish a note, optionally as a reply or a quote, with a content warning, files from your drive, or a poll. |
| Delete file from drive | Delete a file from the connected account's drive. |
| Delete note | Delete one of the connected account's own notes or renotes. |
| Follow account | Follow an account. |
| Get account | Look an account up by handle, profile link or ID: its ID, name, bio, counts, and whether you follow each other. |
| Get an account's notes | Read the notes one account has published, newest first, optionally with its replies, without its renotes, or only those with files. |
| Get my account | Read the account this connection acts as: its username, ID, name, counts and unread notifications. |
| Get note | Read one note in full: who wrote it, its text, files, reactions and counts, and the connected account's own reaction to it. |
| Get notes with a hashtag | Read the notes carrying a hashtag, newest first. |
| Get replies | Read the replies to a note, newest first. |
| Get server info | Read what the connected server is and what it allows: its name, Misskey version, the longest note it accepts, the largest file, and which timelines and search are turned on. |
| Get timeline | Read a timeline, newest first: your home timeline, everyone on this server, both together, or every server this one knows. |
| Get trending hashtags | Read the hashtags trending on the server right now, with how many people used each lately. |
| List notifications | Read the connected account's notifications, newest first: mentions, replies, renotes, reactions, new followers and the rest. |
| Remove reaction | Take back the connected account's reaction to a note. |
| Renote | Share someone's note with your followers, as it is. |
| Search notes | Search the notes this server knows for words, newest first. |
| Unfollow account | Stop following an account. |
| Upload file to drive | Put a file in the connected account's drive. |
Add reaction
React to a note with an emoji. An account has one reaction per note: reacting again replaces it on current Misskey, and older servers ask you to remove the first one.
Inputs
- Note
notetextRequired - The note to act on. Paste its link from your server, or use an ID from an earlier step.
- Reaction
reactiontextRequired - Pick a reaction or one of the server's custom emoji, or type any emoji. ❤ is Misskey's like.
Outputs
The reaction made
note_idtext- The note reacted to
reactedtrue/false- Always true once reacted
reactiontext- The reaction used
Example output
{
"note_id": "9x8mqd0cdg",
"reacted": true,
"reaction": "\ud83d\udc4d"
}Create note
Publish a note, optionally as a reply or a quote, with a content warning, files from your drive, or a poll.
Inputs
- Text
texttext - What the note says. Mention people with @someone and add hashtags with #tag. Can be empty when files or a poll are attached.
- Who can see it
visibilitytext - Defaults to public. Direct notes are seen only by the people the text mentions.One of:
public,home(Home (not on the public timelines)),followers(Followers only),specified(Direct (only the people mentioned)). - Content warning
cwtext - Shown in place of the text until the reader opens it. Up to 100 characters.
- Files to attach
file_idslist - Up to 16 files from your drive. Pick recent ones, or use the ID from an 'Upload file to drive' step.
- Reply to
reply_totext - The note this one replies to: its link or its ID. Leave empty to start a new thread.
- Quote
quotetext - A note to quote below this one's text: its link or its ID. To share a note without adding text, use 'Renote' instead.
- Only on this server
local_onlytrue/false - Keep the note from being sent to other servers.
- Poll answers
poll_choiceslist - Add a poll by giving 2 to 10 answers, each up to 50 characters.
- Allow multiple answers
poll_multipletrue/false - Let a voter choose more than one answer.
- Poll ends
poll_ends_atdate and time - When voting closes. Leave empty to keep it open.
Outputs
A note
createdAttext- When it was posted (ISO 8601)
cwtext- The content warning, if any
fileIdslist- The IDs of its files
fileslist- The files attached to it
idtext- The note's ID
linktext- The note's page on the connected server
localOnlytrue/false- Whether it stays on this server
mentionslist- The IDs of the accounts it mentions
myReactiontext- The connected account's own reaction, if any
pollobject- The poll, if it has one
reactionCountnumber- How many reactions it has
reactionsobject- How many of each reaction, keyed by the reaction
renoteobject- For a renote or quote, the note it shares
renoteCountnumber- How many times it was renoted
renoteIdtext- The note this one renotes or quotes
repliesCountnumber- How many replies it has
replyobject- For a reply, the note it answers
replyIdtext- The note this one replies to
tagslist- The hashtags in it, without '#'
texttext- The text; empty for a plain renote
uritext- For a note from another server, its address there
urltext- For a note from another server, its page there
userobject- The author
userIdtext- The author's account ID
visibilitytext- public, home, followers or specified
Example output
{
"createdAt": "2026-09-14T09:30:00.000Z",
"cw": null,
"fileIds": [
"9x8mqd0cdf"
],
"files": [
{
"comment": "A bar chart of this week's sign-ups",
"createdAt": "2026-09-14T09:29:00.000Z",
"id": "9x8mqd0cdf",
"isSensitive": false,
"name": "chart.png",
"size": 20480,
"thumbnailUrl": "https://misskey.example/files/thumbnail-chart.webp",
"type": "image/png",
"url": "https://misskey.example/files/chart.png"
}
],
"id": "9x8mqd0cdg",
"link": "https://misskey.example/notes/9x8mqd0cdg",
"localOnly": false,
"mentions": [],
"myReaction": null,
"poll": null,
"reactionCount": 1,
"reactions": {
"\ud83d\udc4d": 1
},
"renote": null,
"renoteCount": 0,
"renoteId": null,
"repliesCount": 0,
"reply": null,
"replyId": null,
"tags": [
"lodol"
],
"text": "Hello from a workflow #lodol",
"uri": null,
"url": null,
"user": {
"avatarUrl": "https://misskey.example/identicon/lodol",
"host": null,
"id": "9x8mqd0cde",
"isBot": false,
"name": "Lodol",
"username": "lodol"
},
"userId": "9x8mqd0cde",
"visibility": "public"
}Delete file from drive
Delete a file from the connected account's drive. Notes it was attached to lose it too.
Inputs
- File
file_idtextRequired - The file to delete. Pick a recent one, or use the ID from an 'Upload file to drive' step.
Outputs
What was deleted
deletedtrue/false- Always true once deleted
file_idtext- The deleted file's ID
Example output
{
"deleted": true,
"file_id": "9x8mqd0cdf"
}Delete note
Delete one of the connected account's own notes or renotes.
Inputs
- Note
notetextRequired - The note to act on. Paste its link from your server, or use an ID from an earlier step.
Outputs
What was deleted
deletedtrue/false- Always true once deleted
note_idtext- The deleted note's ID
Example output
{
"deleted": true,
"note_id": "9x8mqd0cdg"
}Follow account
Follow an account. A locked account turns this into a request: 'follow_requested' is then true and nothing is followed until its owner approves.
Inputs
- Account
usertextRequired - The account to act on: a handle such as @someone or @someone@misskey.io, a link to their profile, or an account ID from an earlier step.
Outputs
Where you stand with the account
follow_requestedtrue/false- True when the account is locked and must approve the follow
hosttext- The account's server; empty for this server
is_followed_by_themtrue/false- Whether it follows you
is_followingtrue/false- Whether you now follow it
userobject- An account
user_idtext- The account's ID
usernametext- The account's username
Example output
{
"follow_requested": false,
"host": null,
"is_followed_by_them": false,
"is_following": true,
"user": {
"avatarUrl": "https://misskey.example/identicon/lodol",
"createdAt": "2026-01-05T00:00:00.000Z",
"description": "Automation account.",
"followersCount": 17,
"followingCount": 23,
"hasPendingFollowRequestFromYou": false,
"host": null,
"id": "9x8mqd0cde",
"isBot": false,
"isFollowed": false,
"isFollowing": true,
"isLocked": false,
"name": "Lodol",
"notesCount": 42,
"url": null,
"username": "lodol"
},
"user_id": "9x8mqd0cde",
"username": "lodol"
}Get account
Look an account up by handle, profile link or ID: its ID, name, bio, counts, and whether you follow each other. An account on another server is fetched from there the first time.
Inputs
- Account
usertextRequired - The account to act on: a handle such as @someone or @someone@misskey.io, a link to their profile, or an account ID from an earlier step.
Outputs
An account
avatarUrltext- Link to the avatar image
createdAttext- When the account was made (ISO 8601)
descriptiontext- The bio
followersCountnumber- How many followers it has
followingCountnumber- How many accounts it follows
hasPendingFollowRequestFromYoutrue/false- Whether your follow is waiting for approval
hosttext- The account's server; empty for this server
idtext- The account's ID
isBottrue/false- Whether the account says it is a bot
isFollowedtrue/false- Whether it follows you
isFollowingtrue/false- Whether you follow this account
isLockedtrue/false- Whether follows need the owner's approval
nametext- The display name, if set
notesCountnumber- How many notes it has posted
urltext- For an account on another server, its page there
usernametext- The username, without '@'
Example output
{
"avatarUrl": "https://misskey.example/identicon/lodol",
"createdAt": "2026-01-05T00:00:00.000Z",
"description": "Automation account.",
"followersCount": 17,
"followingCount": 23,
"hasPendingFollowRequestFromYou": false,
"host": null,
"id": "9x8mqd0cde",
"isBot": false,
"isFollowed": false,
"isFollowing": false,
"isLocked": false,
"name": "Lodol",
"notesCount": 42,
"url": null,
"username": "lodol"
}Get an account's notes
Read the notes one account has published, newest first, optionally with its replies, without its renotes, or only those with files.
Inputs
- Account
usertextRequired - The account to act on: a handle such as @someone or @someone@misskey.io, a link to their profile, or an account ID from an earlier step.
- Include replies
with_repliestrue/false - Include the account's replies to others. Off by default.
- Include renotes
with_renotestrue/false - Include notes that only renote someone else's. On by default.
- Only notes with files
with_filestrue/false - Leave out notes that have no image, video or other file attached.
- How many
limitnumber - How many to return, up to 100. Misskey returns 10 when this is empty.From 1 to 100.
- Older than (ID)
until_idtext - Return only results older than this ID. Pass the previous step's 'oldest_id' to read the next page.
- Newer than (ID)
since_idtext - Return only results newer than this ID. Pass an earlier step's 'newest_id' to read what has arrived since.
Outputs
The account's notes
countnumber- How many came back
newest_idtext- Pass as 'Newer than (ID)' to read what arrives next
noteslist- The account's notes
oldest_idtext- Pass as 'Older than (ID)' to read the next, older page
user_idtext- The account read
Example output
{
"count": 1,
"newest_id": "9x8mqd0cdg",
"notes": [
{
"createdAt": "2026-09-14T09:30:00.000Z",
"cw": null,
"fileIds": [
"9x8mqd0cdf"
],
"files": [
{
"comment": "A bar chart of this week's sign-ups",
"createdAt": "2026-09-14T09:29:00.000Z",
"id": "9x8mqd0cdf",
"isSensitive": false,
"name": "chart.png",
"size": 20480,
"thumbnailUrl": "https://misskey.example/files/thumbnail-chart.webp",
"type": "image/png",
"url": "https://misskey.example/files/chart.png"
}
],
"id": "9x8mqd0cdg",
"link": "https://misskey.example/notes/9x8mqd0cdg",
"localOnly": false,
"mentions": [],
"myReaction": null,
"poll": null,
"reactionCount": 1,
"reactions": {
"\ud83d\udc4d": 1
},
"renote": null,
"renoteCount": 0,
"renoteId": null,
"repliesCount": 0,
"reply": null,
"replyId": null,
"tags": [
"lodol"
],
"text": "Hello from a workflow #lodol",
"uri": null,
"url": null,
"user": {
"avatarUrl": "https://misskey.example/identicon/lodol",
"host": null,
"id": "9x8mqd0cde",
"isBot": false,
"name": "Lodol",
"username": "lodol"
},
"userId": "9x8mqd0cde",
"visibility": "public"
}
],
"oldest_id": "9x8mqd0cdg",
"user_id": "9x8mqd0cde"
}Get my account
Read the account this connection acts as: its username, ID, name, counts and unread notifications.
Inputs
None.
Outputs
The connected account
avatarUrltext- Link to the avatar image
createdAttext- When the account was made (ISO 8601)
descriptiontext- The bio
followersCountnumber- How many followers it has
followingCountnumber- How many accounts it follows
idtext- The account's ID
isAdmintrue/false- Whether it administers the server
isBottrue/false- Whether the account says it is a bot
isLockedtrue/false- Whether follows need its approval
isModeratortrue/false- Whether it moderates the server
nametext- The display name, if set
notesCountnumber- How many notes it has posted
unreadNotificationsCountnumber- How many notifications are unread
usernametext- The username, without '@'
Example output
{
"avatarUrl": "https://misskey.example/identicon/lodol",
"createdAt": "2026-01-05T00:00:00.000Z",
"description": "Automation account.",
"followersCount": 17,
"followingCount": 23,
"id": "9x8mqd0cde",
"isAdmin": false,
"isBot": false,
"isLocked": false,
"isModerator": false,
"name": "Lodol",
"notesCount": 42,
"unreadNotificationsCount": 0,
"username": "lodol"
}Get note
Read one note in full: who wrote it, its text, files, reactions and counts, and the connected account's own reaction to it.
Inputs
- Note
notetextRequired - The note to act on. Paste its link from your server, or use an ID from an earlier step.
Outputs
A note
createdAttext- When it was posted (ISO 8601)
cwtext- The content warning, if any
fileIdslist- The IDs of its files
fileslist- The files attached to it
idtext- The note's ID
linktext- The note's page on the connected server
localOnlytrue/false- Whether it stays on this server
mentionslist- The IDs of the accounts it mentions
myReactiontext- The connected account's own reaction, if any
pollobject- The poll, if it has one
reactionCountnumber- How many reactions it has
reactionsobject- How many of each reaction, keyed by the reaction
renoteobject- For a renote or quote, the note it shares
renoteCountnumber- How many times it was renoted
renoteIdtext- The note this one renotes or quotes
repliesCountnumber- How many replies it has
replyobject- For a reply, the note it answers
replyIdtext- The note this one replies to
tagslist- The hashtags in it, without '#'
texttext- The text; empty for a plain renote
uritext- For a note from another server, its address there
urltext- For a note from another server, its page there
userobject- The author
userIdtext- The author's account ID
visibilitytext- public, home, followers or specified
Example output
{
"createdAt": "2026-09-14T09:30:00.000Z",
"cw": null,
"fileIds": [
"9x8mqd0cdf"
],
"files": [
{
"comment": "A bar chart of this week's sign-ups",
"createdAt": "2026-09-14T09:29:00.000Z",
"id": "9x8mqd0cdf",
"isSensitive": false,
"name": "chart.png",
"size": 20480,
"thumbnailUrl": "https://misskey.example/files/thumbnail-chart.webp",
"type": "image/png",
"url": "https://misskey.example/files/chart.png"
}
],
"id": "9x8mqd0cdg",
"link": "https://misskey.example/notes/9x8mqd0cdg",
"localOnly": false,
"mentions": [],
"myReaction": null,
"poll": null,
"reactionCount": 1,
"reactions": {
"\ud83d\udc4d": 1
},
"renote": null,
"renoteCount": 0,
"renoteId": null,
"repliesCount": 0,
"reply": null,
"replyId": null,
"tags": [
"lodol"
],
"text": "Hello from a workflow #lodol",
"uri": null,
"url": null,
"user": {
"avatarUrl": "https://misskey.example/identicon/lodol",
"host": null,
"id": "9x8mqd0cde",
"isBot": false,
"name": "Lodol",
"username": "lodol"
},
"userId": "9x8mqd0cde",
"visibility": "public"
}Get notes with a hashtag
Read the notes carrying a hashtag, newest first. Works on every server, including those that turn search off.
Inputs
- Hashtag
hashtagtextRequired - One hashtag, with or without its '#'.
- Only notes with files
with_filestrue/false - Leave out notes that have no image, video or other file attached.
- How many
limitnumber - How many to return, up to 100. Misskey returns 10 when this is empty.From 1 to 100.
- Older than (ID)
until_idtext - Return only results older than this ID. Pass the previous step's 'oldest_id' to read the next page.
Outputs
The notes carrying the hashtag
countnumber- How many came back
hashtagtext- The hashtag read
newest_idtext- Pass as 'Newer than (ID)' to read what arrives next
noteslist- The notes carrying the hashtag
oldest_idtext- Pass as 'Older than (ID)' to read the next, older page
Example output
{
"count": 1,
"hashtag": "lodol",
"newest_id": "9x8mqd0cdg",
"notes": [
{
"createdAt": "2026-09-14T09:30:00.000Z",
"cw": null,
"fileIds": [
"9x8mqd0cdf"
],
"files": [
{
"comment": "A bar chart of this week's sign-ups",
"createdAt": "2026-09-14T09:29:00.000Z",
"id": "9x8mqd0cdf",
"isSensitive": false,
"name": "chart.png",
"size": 20480,
"thumbnailUrl": "https://misskey.example/files/thumbnail-chart.webp",
"type": "image/png",
"url": "https://misskey.example/files/chart.png"
}
],
"id": "9x8mqd0cdg",
"link": "https://misskey.example/notes/9x8mqd0cdg",
"localOnly": false,
"mentions": [],
"myReaction": null,
"poll": null,
"reactionCount": 1,
"reactions": {
"\ud83d\udc4d": 1
},
"renote": null,
"renoteCount": 0,
"renoteId": null,
"repliesCount": 0,
"reply": null,
"replyId": null,
"tags": [
"lodol"
],
"text": "Hello from a workflow #lodol",
"uri": null,
"url": null,
"user": {
"avatarUrl": "https://misskey.example/identicon/lodol",
"host": null,
"id": "9x8mqd0cde",
"isBot": false,
"name": "Lodol",
"username": "lodol"
},
"userId": "9x8mqd0cde",
"visibility": "public"
}
],
"oldest_id": "9x8mqd0cdg"
}Get replies
Read the replies to a note, newest first. This is how a workflow reads the answers to something it posted.
Inputs
- Note
notetextRequired - The note to act on. Paste its link from your server, or use an ID from an earlier step.
- How many
limitnumber - How many to return, up to 100. Misskey returns 10 when this is empty.From 1 to 100.
- Older than (ID)
until_idtext - Return only results older than this ID. Pass the previous step's 'oldest_id' to read the next page.
Outputs
The replies to the note
countnumber- How many came back
newest_idtext- Pass as 'Newer than (ID)' to read what arrives next
note_idtext- The note replied to
noteslist- The replies to the note
oldest_idtext- Pass as 'Older than (ID)' to read the next, older page
Example output
{
"count": 1,
"newest_id": "9x8mqd0cdg",
"note_id": "9x8mqd0cdf",
"notes": [
{
"createdAt": "2026-09-14T09:30:00.000Z",
"cw": null,
"fileIds": [
"9x8mqd0cdf"
],
"files": [
{
"comment": "A bar chart of this week's sign-ups",
"createdAt": "2026-09-14T09:29:00.000Z",
"id": "9x8mqd0cdf",
"isSensitive": false,
"name": "chart.png",
"size": 20480,
"thumbnailUrl": "https://misskey.example/files/thumbnail-chart.webp",
"type": "image/png",
"url": "https://misskey.example/files/chart.png"
}
],
"id": "9x8mqd0cdg",
"link": "https://misskey.example/notes/9x8mqd0cdg",
"localOnly": false,
"mentions": [],
"myReaction": null,
"poll": null,
"reactionCount": 1,
"reactions": {
"\ud83d\udc4d": 1
},
"renote": null,
"renoteCount": 0,
"renoteId": null,
"repliesCount": 0,
"reply": null,
"replyId": null,
"tags": [
"lodol"
],
"text": "Hello from a workflow #lodol",
"uri": null,
"url": null,
"user": {
"avatarUrl": "https://misskey.example/identicon/lodol",
"host": null,
"id": "9x8mqd0cde",
"isBot": false,
"name": "Lodol",
"username": "lodol"
},
"userId": "9x8mqd0cde",
"visibility": "public"
}
],
"oldest_id": "9x8mqd0cdg"
}Get server info
Read what the connected server is and what it allows: its name, Misskey version, the longest note it accepts, the largest file, and which timelines and search are turned on.
Inputs
None.
Outputs
The connected server
descriptiontext- The server's description
drive_capacity_mbnumber- Drive space per account, in MB
email_required_for_signuptrue/false- Whether sign-up needs an email
global_timeline_availabletrue/false- Whether the global timeline is on
icon_urltext- Link to its icon
languageslist- The languages it is run in
local_timeline_availabletrue/false- Whether the local timeline is on
maintainer_nametext- Who runs the server
max_file_size_mbnumber- The largest file it accepts, in MB
max_note_lengthnumber- The longest note it accepts, in characters
nametext- The server's name
note_search_availabletrue/false- Whether ordinary accounts may search notes
registrations_opentrue/false- Whether anyone may sign up
terms_urltext- Link to its terms
uritext- The server's address
versiontext- The Misskey version it runs
Example output
{
"description": "An example Misskey server.",
"drive_capacity_mb": 100,
"email_required_for_signup": true,
"global_timeline_available": true,
"icon_url": null,
"languages": [
"en"
],
"local_timeline_available": true,
"maintainer_name": "Admin",
"max_file_size_mb": 30,
"max_note_length": 3000,
"name": "Misskey Example",
"note_search_available": true,
"registrations_open": true,
"terms_url": null,
"uri": "https://misskey.example",
"version": "2026.10.0"
}Get timeline
Read a timeline, newest first: your home timeline, everyone on this server, both together, or every server this one knows. Servers can turn the local and global timelines off; when they have, the step says so.
Inputs
- Timeline
timelinetext - Which timeline to read. Defaults to Home.One of:
home(Home (accounts you follow)),local(Local (everyone on this server)),social(Social (accounts you follow and this server)),global(Global (every server this one knows)). - Only notes with files
with_filestrue/false - Leave out notes that have no image, video or other file attached.
- Include renotes
with_renotestrue/false - Include notes that only renote someone else's. On by default.
- How many
limitnumber - How many to return, up to 100. Misskey returns 10 when this is empty.From 1 to 100.
- Older than (ID)
until_idtext - Return only results older than this ID. Pass the previous step's 'oldest_id' to read the next page.
- Newer than (ID)
since_idtext - Return only results newer than this ID. Pass an earlier step's 'newest_id' to read what has arrived since.
Outputs
The notes on the timeline
countnumber- How many came back
newest_idtext- Pass as 'Newer than (ID)' to read what arrives next
noteslist- The notes on the timeline
oldest_idtext- Pass as 'Older than (ID)' to read the next, older page
timelinetext- The timeline read
Example output
{
"count": 1,
"newest_id": "9x8mqd0cdg",
"notes": [
{
"createdAt": "2026-09-14T09:30:00.000Z",
"cw": null,
"fileIds": [
"9x8mqd0cdf"
],
"files": [
{
"comment": "A bar chart of this week's sign-ups",
"createdAt": "2026-09-14T09:29:00.000Z",
"id": "9x8mqd0cdf",
"isSensitive": false,
"name": "chart.png",
"size": 20480,
"thumbnailUrl": "https://misskey.example/files/thumbnail-chart.webp",
"type": "image/png",
"url": "https://misskey.example/files/chart.png"
}
],
"id": "9x8mqd0cdg",
"link": "https://misskey.example/notes/9x8mqd0cdg",
"localOnly": false,
"mentions": [],
"myReaction": null,
"poll": null,
"reactionCount": 1,
"reactions": {
"\ud83d\udc4d": 1
},
"renote": null,
"renoteCount": 0,
"renoteId": null,
"repliesCount": 0,
"reply": null,
"replyId": null,
"tags": [
"lodol"
],
"text": "Hello from a workflow #lodol",
"uri": null,
"url": null,
"user": {
"avatarUrl": "https://misskey.example/identicon/lodol",
"host": null,
"id": "9x8mqd0cde",
"isBot": false,
"name": "Lodol",
"username": "lodol"
},
"userId": "9x8mqd0cde",
"visibility": "public"
}
],
"oldest_id": "9x8mqd0cdg",
"timeline": "home"
}Get trending hashtags
Read the hashtags trending on the server right now, with how many people used each lately.
Inputs
None.
Outputs
The trending hashtags
countnumber- How many are trending
hashtagslist- The hashtags, most used first
Example output
{
"count": 1,
"hashtags": [
{
"chart": [
3,
5,
4
],
"tag": "lodol",
"users_count": 12
}
]
}List notifications
Read the connected account's notifications, newest first: mentions, replies, renotes, reactions, new followers and the rest. They stay unread in Misskey unless you choose otherwise.
Inputs
- Only these kinds
typeslist - Return only these kinds. Leave empty for all of them. Misskey takes the most recent notifications first and then filters them, so fewer than 'How many' can come back.One or more of:
mention(Mentions),reply(Replies),renote(Renotes),quote(Quotes),reaction(Reactions),follow(New followers),receiveFollowRequest(Follow requests),followRequestAccepted(Follow requests accepted),pollEnded(Polls that ended),note(New notes from people you get notified about). - Mark as read
mark_as_readtrue/false - Mark the notifications returned as read in Misskey.
- How many
limitnumber - How many to return, up to 100. Misskey returns 10 when this is empty.From 1 to 100.
- Older than (ID)
until_idtext - Return only results older than this ID. Pass the previous step's 'oldest_id' to read the next page.
- Newer than (ID)
since_idtext - Return only results newer than this ID. Pass an earlier step's 'newest_id' to read what has arrived since.
Outputs
The account's notifications
countnumber- How many came back
newest_idtext- Pass as 'Newer than (ID)' to read what arrives next
notificationslist- The account's notifications
oldest_idtext- Pass as 'Older than (ID)' to read the next, older page
Example output
{
"count": 1,
"newest_id": "9x8mqd0cdh",
"notifications": [
{
"createdAt": "2026-09-14T09:35:00.000Z",
"id": "9x8mqd0cdh",
"note": {
"createdAt": "2026-09-14T09:30:00.000Z",
"cw": null,
"fileIds": [
"9x8mqd0cdf"
],
"files": [
{
"comment": "A bar chart of this week's sign-ups",
"createdAt": "2026-09-14T09:29:00.000Z",
"id": "9x8mqd0cdf",
"isSensitive": false,
"name": "chart.png",
"size": 20480,
"thumbnailUrl": "https://misskey.example/files/thumbnail-chart.webp",
"type": "image/png",
"url": "https://misskey.example/files/chart.png"
}
],
"id": "9x8mqd0cdg",
"link": "https://misskey.example/notes/9x8mqd0cdg",
"localOnly": false,
"mentions": [],
"myReaction": null,
"poll": null,
"reactionCount": 1,
"reactions": {
"\ud83d\udc4d": 1
},
"renote": null,
"renoteCount": 0,
"renoteId": null,
"repliesCount": 0,
"reply": null,
"replyId": null,
"tags": [
"lodol"
],
"text": "Hello from a workflow #lodol",
"uri": null,
"url": null,
"user": {
"avatarUrl": "https://misskey.example/identicon/lodol",
"host": null,
"id": "9x8mqd0cde",
"isBot": false,
"name": "Lodol",
"username": "lodol"
},
"userId": "9x8mqd0cde",
"visibility": "public"
},
"reaction": null,
"type": "mention",
"user": {
"avatarUrl": "https://misskey.example/identicon/lodol",
"host": null,
"id": "9x8mqd0cde",
"isBot": false,
"name": "Lodol",
"username": "lodol"
}
}
],
"oldest_id": "9x8mqd0cdh"
}Remove reaction
Take back the connected account's reaction to a note.
Inputs
- Note
notetextRequired - The note to act on. Paste its link from your server, or use an ID from an earlier step.
Outputs
The reaction removed
note_idtext- The note it was removed from
removedtrue/false- Always true once removed
Example output
{
"note_id": "9x8mqd0cdg",
"removed": true
}Renote
Share someone's note with your followers, as it is. What comes back is the renote itself, with the shared note inside it under 'renote'; delete the renote to undo it.
Inputs
- Note
notetextRequired - The note to act on. Paste its link from your server, or use an ID from an earlier step.
- Who sees the renote
visibilitytext - Defaults to public.One of:
public,home(Home (not on the public timelines)),followers(Followers only).
Outputs
A note
createdAttext- When it was posted (ISO 8601)
cwtext- The content warning, if any
fileIdslist- The IDs of its files
fileslist- The files attached to it
idtext- The note's ID
linktext- The note's page on the connected server
localOnlytrue/false- Whether it stays on this server
mentionslist- The IDs of the accounts it mentions
myReactiontext- The connected account's own reaction, if any
pollobject- The poll, if it has one
reactionCountnumber- How many reactions it has
reactionsobject- How many of each reaction, keyed by the reaction
renoteobject- For a renote or quote, the note it shares
renoteCountnumber- How many times it was renoted
renoteIdtext- The note this one renotes or quotes
repliesCountnumber- How many replies it has
replyobject- For a reply, the note it answers
replyIdtext- The note this one replies to
tagslist- The hashtags in it, without '#'
texttext- The text; empty for a plain renote
uritext- For a note from another server, its address there
urltext- For a note from another server, its page there
userobject- The author
userIdtext- The author's account ID
visibilitytext- public, home, followers or specified
Example output
{
"createdAt": "2026-09-14T09:30:00.000Z",
"cw": null,
"fileIds": [
"9x8mqd0cdf"
],
"files": [
{
"comment": "A bar chart of this week's sign-ups",
"createdAt": "2026-09-14T09:29:00.000Z",
"id": "9x8mqd0cdf",
"isSensitive": false,
"name": "chart.png",
"size": 20480,
"thumbnailUrl": "https://misskey.example/files/thumbnail-chart.webp",
"type": "image/png",
"url": "https://misskey.example/files/chart.png"
}
],
"id": "9x8mqd0cdj",
"link": "https://misskey.example/notes/9x8mqd0cdj",
"localOnly": false,
"mentions": [],
"myReaction": null,
"poll": null,
"reactionCount": 1,
"reactions": {
"\ud83d\udc4d": 1
},
"renote": {
"createdAt": "2026-09-14T09:30:00.000Z",
"cw": null,
"fileIds": [
"9x8mqd0cdf"
],
"files": [
{
"comment": "A bar chart of this week's sign-ups",
"createdAt": "2026-09-14T09:29:00.000Z",
"id": "9x8mqd0cdf",
"isSensitive": false,
"name": "chart.png",
"size": 20480,
"thumbnailUrl": "https://misskey.example/files/thumbnail-chart.webp",
"type": "image/png",
"url": "https://misskey.example/files/chart.png"
}
],
"id": "9x8mqd0cdg",
"link": "https://misskey.example/notes/9x8mqd0cdg",
"localOnly": false,
"mentions": [],
"myReaction": null,
"poll": null,
"reactionCount": 1,
"reactions": {
"\ud83d\udc4d": 1
},
"renote": null,
"renoteCount": 0,
"renoteId": null,
"repliesCount": 0,
"reply": null,
"replyId": null,
"tags": [
"lodol"
],
"text": "Hello from a workflow #lodol",
"uri": null,
"url": null,
"user": {
"avatarUrl": "https://misskey.example/identicon/lodol",
"host": null,
"id": "9x8mqd0cde",
"isBot": false,
"name": "Lodol",
"username": "lodol"
},
"userId": "9x8mqd0cde",
"visibility": "public"
},
"renoteCount": 0,
"renoteId": "9x8mqd0cdg",
"repliesCount": 0,
"reply": null,
"replyId": null,
"tags": [
"lodol"
],
"text": null,
"uri": null,
"url": null,
"user": {
"avatarUrl": "https://misskey.example/identicon/lodol",
"host": null,
"id": "9x8mqd0cde",
"isBot": false,
"name": "Lodol",
"username": "lodol"
},
"userId": "9x8mqd0cde",
"visibility": "public"
}Search notes
Search the notes this server knows for words, newest first. Some servers turn search off for ordinary accounts; when they have, the step says so.
Inputs
- Search for
querytextRequired - The words to look for.
- Only notes by
usertext - Keep only notes by this account: a handle, a profile link or an account ID.
- Only this server's notes
this_server_onlytrue/false - Leave out notes from other servers.
- How many
limitnumber - How many to return, up to 100. Misskey returns 10 when this is empty.From 1 to 100.
- Older than (ID)
until_idtext - Return only results older than this ID. Pass the previous step's 'oldest_id' to read the next page.
Outputs
The notes that matched
countnumber- How many came back
newest_idtext- Pass as 'Newer than (ID)' to read what arrives next
noteslist- The notes that matched
oldest_idtext- Pass as 'Older than (ID)' to read the next, older page
querytext- What was searched for
Example output
{
"count": 1,
"newest_id": "9x8mqd0cdg",
"notes": [
{
"createdAt": "2026-09-14T09:30:00.000Z",
"cw": null,
"fileIds": [
"9x8mqd0cdf"
],
"files": [
{
"comment": "A bar chart of this week's sign-ups",
"createdAt": "2026-09-14T09:29:00.000Z",
"id": "9x8mqd0cdf",
"isSensitive": false,
"name": "chart.png",
"size": 20480,
"thumbnailUrl": "https://misskey.example/files/thumbnail-chart.webp",
"type": "image/png",
"url": "https://misskey.example/files/chart.png"
}
],
"id": "9x8mqd0cdg",
"link": "https://misskey.example/notes/9x8mqd0cdg",
"localOnly": false,
"mentions": [],
"myReaction": null,
"poll": null,
"reactionCount": 1,
"reactions": {
"\ud83d\udc4d": 1
},
"renote": null,
"renoteCount": 0,
"renoteId": null,
"repliesCount": 0,
"reply": null,
"replyId": null,
"tags": [
"lodol"
],
"text": "Hello from a workflow #lodol",
"uri": null,
"url": null,
"user": {
"avatarUrl": "https://misskey.example/identicon/lodol",
"host": null,
"id": "9x8mqd0cde",
"isBot": false,
"name": "Lodol",
"username": "lodol"
},
"userId": "9x8mqd0cde",
"visibility": "public"
}
],
"oldest_id": "9x8mqd0cdg",
"query": "workflow"
}Unfollow account
Stop following an account.
Inputs
- Account
usertextRequired - The account to act on: a handle such as @someone or @someone@misskey.io, a link to their profile, or an account ID from an earlier step.
Outputs
Where you stand with the account
follow_requestedtrue/false- True when the account is locked and must approve the follow
hosttext- The account's server; empty for this server
is_followed_by_themtrue/false- Whether it follows you
is_followingtrue/false- Whether you now follow it
userobject- An account
user_idtext- The account's ID
usernametext- The account's username
Example output
{
"follow_requested": false,
"host": null,
"is_followed_by_them": false,
"is_following": false,
"user": {
"avatarUrl": "https://misskey.example/identicon/lodol",
"createdAt": "2026-01-05T00:00:00.000Z",
"description": "Automation account.",
"followersCount": 17,
"followingCount": 23,
"hasPendingFollowRequestFromYou": false,
"host": null,
"id": "9x8mqd0cde",
"isBot": false,
"isFollowed": false,
"isFollowing": false,
"isLocked": false,
"name": "Lodol",
"notesCount": 42,
"url": null,
"username": "lodol"
},
"user_id": "9x8mqd0cde",
"username": "lodol"
}Upload file to drive
Put a file in the connected account's drive. Pass the ID it returns to 'Files to attach' on 'Create note' to post it.
Inputs
- File
filetextRequired - Upload a file, pick one from an earlier step, or paste a link to a public PNG, JPEG or WebP image.
- File name
nametext - Defaults to the uploaded file's own name.
- Caption
captiontext - Describes the file for people using screen readers. Up to 512 characters.
- Mark as sensitive
sensitivetrue/false - Hide the file behind a click-to-view wherever it appears.
Outputs
A file in the account's drive
commenttext- The caption (alt text)
createdAttext- When it was uploaded (ISO 8601)
idtext- The file's ID, for 'Files to attach'
isSensitivetrue/false- Whether it is hidden behind a click-to-view
nametext- The file name
sizenumber- Size in bytes
thumbnailUrltext- Link to a thumbnail, for images
typetext- The media type, such as image/png
urltext- Link to the file
Example output
{
"comment": "A bar chart of this week's sign-ups",
"createdAt": "2026-09-14T09:29:00.000Z",
"id": "9x8mqd0cdf",
"isSensitive": false,
"name": "chart.png",
"size": 20480,
"thumbnailUrl": "https://misskey.example/files/thumbnail-chart.webp",
"type": "image/png",
"url": "https://misskey.example/files/chart.png"
}