# Misskey

> 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.

App · 20 actions. Web page: https://docs.lodol.com/docs/integrations/misskey

## Actions

### 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 (`note`, text, required): The note to act on. Paste its link from your server, or use an ID from an earlier step.
- Reaction (`reaction`, text, required): Pick a reaction or one of the server's custom emoji, or type any emoji. ❤ is Misskey's like.

**Outputs**: The reaction made

- `note_id` (text): The note reacted to
- `reacted` (true/false): Always true once reacted
- `reaction` (text): The reaction used

**Example output**

```json
{
  "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 (`text`, text): 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 (`visibility`, text): 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 (`cw`, text): Shown in place of the text until the reader opens it. Up to 100 characters.
- Files to attach (`file_ids`, list): Up to 16 files from your drive. Pick recent ones, or use the ID from an 'Upload file to drive' step.
- Reply to (`reply_to`, text): The note this one replies to: its link or its ID. Leave empty to start a new thread.
- Quote (`quote`, text): 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_only`, true/false): Keep the note from being sent to other servers.
- Poll answers (`poll_choices`, list): Add a poll by giving 2 to 10 answers, each up to 50 characters.
- Allow multiple answers (`poll_multiple`, true/false): Let a voter choose more than one answer.
- Poll ends (`poll_ends_at`, date and time): When voting closes. Leave empty to keep it open.

**Outputs**: A note

- `createdAt` (text): When it was posted (ISO 8601)
- `cw` (text): The content warning, if any
- `fileIds` (list): The IDs of its files
- `files` (list): The files attached to it
- `id` (text): The note's ID
- `link` (text): The note's page on the connected server
- `localOnly` (true/false): Whether it stays on this server
- `mentions` (list): The IDs of the accounts it mentions
- `myReaction` (text): The connected account's own reaction, if any
- `poll` (object): The poll, if it has one
- `reactionCount` (number): How many reactions it has
- `reactions` (object): How many of each reaction, keyed by the reaction
- `renote` (object): For a renote or quote, the note it shares
- `renoteCount` (number): How many times it was renoted
- `renoteId` (text): The note this one renotes or quotes
- `repliesCount` (number): How many replies it has
- `reply` (object): For a reply, the note it answers
- `replyId` (text): The note this one replies to
- `tags` (list): The hashtags in it, without '#'
- `text` (text): The text; empty for a plain renote
- `uri` (text): For a note from another server, its address there
- `url` (text): For a note from another server, its page there
- `user` (object): The author
- `userId` (text): The author's account ID
- `visibility` (text): public, home, followers or specified

**Example output**

```json
{
  "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_id`, text, required): The file to delete. Pick a recent one, or use the ID from an 'Upload file to drive' step.

**Outputs**: What was deleted

- `deleted` (true/false): Always true once deleted
- `file_id` (text): The deleted file's ID

**Example output**

```json
{
  "deleted": true,
  "file_id": "9x8mqd0cdf"
}
```

### Delete note

Delete one of the connected account's own notes or renotes.

**Inputs**

- Note (`note`, text, required): The note to act on. Paste its link from your server, or use an ID from an earlier step.

**Outputs**: What was deleted

- `deleted` (true/false): Always true once deleted
- `note_id` (text): The deleted note's ID

**Example output**

```json
{
  "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 (`user`, text, required): 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_requested` (true/false): True when the account is locked and must approve the follow
- `host` (text): The account's server; empty for this server
- `is_followed_by_them` (true/false): Whether it follows you
- `is_following` (true/false): Whether you now follow it
- `user` (object): An account
- `user_id` (text): The account's ID
- `username` (text): The account's username

**Example output**

```json
{
  "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 (`user`, text, required): 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

- `avatarUrl` (text): Link to the avatar image
- `createdAt` (text): When the account was made (ISO 8601)
- `description` (text): The bio
- `followersCount` (number): How many followers it has
- `followingCount` (number): How many accounts it follows
- `hasPendingFollowRequestFromYou` (true/false): Whether your follow is waiting for approval
- `host` (text): The account's server; empty for this server
- `id` (text): The account's ID
- `isBot` (true/false): Whether the account says it is a bot
- `isFollowed` (true/false): Whether it follows you
- `isFollowing` (true/false): Whether you follow this account
- `isLocked` (true/false): Whether follows need the owner's approval
- `name` (text): The display name, if set
- `notesCount` (number): How many notes it has posted
- `url` (text): For an account on another server, its page there
- `username` (text): The username, without '@'

**Example output**

```json
{
  "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 (`user`, text, required): 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_replies`, true/false): Include the account's replies to others. Off by default.
- Include renotes (`with_renotes`, true/false): Include notes that only renote someone else's. On by default.
- Only notes with files (`with_files`, true/false): Leave out notes that have no image, video or other file attached.
- How many (`limit`, number): How many to return, up to 100. Misskey returns 10 when this is empty. From 1 to 100.
- Older than (ID) (`until_id`, text): Return only results older than this ID. Pass the previous step's 'oldest_id' to read the next page.
- Newer than (ID) (`since_id`, text): 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

- `count` (number): How many came back
- `newest_id` (text): Pass as 'Newer than (ID)' to read what arrives next
- `notes` (list): The account's notes
- `oldest_id` (text): Pass as 'Older than (ID)' to read the next, older page
- `user_id` (text): The account read

**Example output**

```json
{
  "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

- `avatarUrl` (text): Link to the avatar image
- `createdAt` (text): When the account was made (ISO 8601)
- `description` (text): The bio
- `followersCount` (number): How many followers it has
- `followingCount` (number): How many accounts it follows
- `id` (text): The account's ID
- `isAdmin` (true/false): Whether it administers the server
- `isBot` (true/false): Whether the account says it is a bot
- `isLocked` (true/false): Whether follows need its approval
- `isModerator` (true/false): Whether it moderates the server
- `name` (text): The display name, if set
- `notesCount` (number): How many notes it has posted
- `unreadNotificationsCount` (number): How many notifications are unread
- `username` (text): The username, without '@'

**Example output**

```json
{
  "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 (`note`, text, required): The note to act on. Paste its link from your server, or use an ID from an earlier step.

**Outputs**: A note

- `createdAt` (text): When it was posted (ISO 8601)
- `cw` (text): The content warning, if any
- `fileIds` (list): The IDs of its files
- `files` (list): The files attached to it
- `id` (text): The note's ID
- `link` (text): The note's page on the connected server
- `localOnly` (true/false): Whether it stays on this server
- `mentions` (list): The IDs of the accounts it mentions
- `myReaction` (text): The connected account's own reaction, if any
- `poll` (object): The poll, if it has one
- `reactionCount` (number): How many reactions it has
- `reactions` (object): How many of each reaction, keyed by the reaction
- `renote` (object): For a renote or quote, the note it shares
- `renoteCount` (number): How many times it was renoted
- `renoteId` (text): The note this one renotes or quotes
- `repliesCount` (number): How many replies it has
- `reply` (object): For a reply, the note it answers
- `replyId` (text): The note this one replies to
- `tags` (list): The hashtags in it, without '#'
- `text` (text): The text; empty for a plain renote
- `uri` (text): For a note from another server, its address there
- `url` (text): For a note from another server, its page there
- `user` (object): The author
- `userId` (text): The author's account ID
- `visibility` (text): public, home, followers or specified

**Example output**

```json
{
  "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 (`hashtag`, text, required): One hashtag, with or without its '#'.
- Only notes with files (`with_files`, true/false): Leave out notes that have no image, video or other file attached.
- How many (`limit`, number): How many to return, up to 100. Misskey returns 10 when this is empty. From 1 to 100.
- Older than (ID) (`until_id`, text): 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

- `count` (number): How many came back
- `hashtag` (text): The hashtag read
- `newest_id` (text): Pass as 'Newer than (ID)' to read what arrives next
- `notes` (list): The notes carrying the hashtag
- `oldest_id` (text): Pass as 'Older than (ID)' to read the next, older page

**Example output**

```json
{
  "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 (`note`, text, required): The note to act on. Paste its link from your server, or use an ID from an earlier step.
- How many (`limit`, number): How many to return, up to 100. Misskey returns 10 when this is empty. From 1 to 100.
- Older than (ID) (`until_id`, text): 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

- `count` (number): How many came back
- `newest_id` (text): Pass as 'Newer than (ID)' to read what arrives next
- `note_id` (text): The note replied to
- `notes` (list): The replies to the note
- `oldest_id` (text): Pass as 'Older than (ID)' to read the next, older page

**Example output**

```json
{
  "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

- `description` (text): The server's description
- `drive_capacity_mb` (number): Drive space per account, in MB
- `email_required_for_signup` (true/false): Whether sign-up needs an email
- `global_timeline_available` (true/false): Whether the global timeline is on
- `icon_url` (text): Link to its icon
- `languages` (list): The languages it is run in
- `local_timeline_available` (true/false): Whether the local timeline is on
- `maintainer_name` (text): Who runs the server
- `max_file_size_mb` (number): The largest file it accepts, in MB
- `max_note_length` (number): The longest note it accepts, in characters
- `name` (text): The server's name
- `note_search_available` (true/false): Whether ordinary accounts may search notes
- `registrations_open` (true/false): Whether anyone may sign up
- `terms_url` (text): Link to its terms
- `uri` (text): The server's address
- `version` (text): The Misskey version it runs

**Example output**

```json
{
  "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 (`timeline`, text): 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_files`, true/false): Leave out notes that have no image, video or other file attached.
- Include renotes (`with_renotes`, true/false): Include notes that only renote someone else's. On by default.
- How many (`limit`, number): How many to return, up to 100. Misskey returns 10 when this is empty. From 1 to 100.
- Older than (ID) (`until_id`, text): Return only results older than this ID. Pass the previous step's 'oldest_id' to read the next page.
- Newer than (ID) (`since_id`, text): 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

- `count` (number): How many came back
- `newest_id` (text): Pass as 'Newer than (ID)' to read what arrives next
- `notes` (list): The notes on the timeline
- `oldest_id` (text): Pass as 'Older than (ID)' to read the next, older page
- `timeline` (text): The timeline read

**Example output**

```json
{
  "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

- `count` (number): How many are trending
- `hashtags` (list): The hashtags, most used first

**Example output**

```json
{
  "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 (`types`, list): 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_read`, true/false): Mark the notifications returned as read in Misskey.
- How many (`limit`, number): How many to return, up to 100. Misskey returns 10 when this is empty. From 1 to 100.
- Older than (ID) (`until_id`, text): Return only results older than this ID. Pass the previous step's 'oldest_id' to read the next page.
- Newer than (ID) (`since_id`, text): 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

- `count` (number): How many came back
- `newest_id` (text): Pass as 'Newer than (ID)' to read what arrives next
- `notifications` (list): The account's notifications
- `oldest_id` (text): Pass as 'Older than (ID)' to read the next, older page

**Example output**

```json
{
  "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 (`note`, text, required): The note to act on. Paste its link from your server, or use an ID from an earlier step.

**Outputs**: The reaction removed

- `note_id` (text): The note it was removed from
- `removed` (true/false): Always true once removed

**Example output**

```json
{
  "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 (`note`, text, required): The note to act on. Paste its link from your server, or use an ID from an earlier step.
- Who sees the renote (`visibility`, text): Defaults to public. One of: `public`, `home` (Home (not on the public timelines)), `followers` (Followers only).

**Outputs**: A note

- `createdAt` (text): When it was posted (ISO 8601)
- `cw` (text): The content warning, if any
- `fileIds` (list): The IDs of its files
- `files` (list): The files attached to it
- `id` (text): The note's ID
- `link` (text): The note's page on the connected server
- `localOnly` (true/false): Whether it stays on this server
- `mentions` (list): The IDs of the accounts it mentions
- `myReaction` (text): The connected account's own reaction, if any
- `poll` (object): The poll, if it has one
- `reactionCount` (number): How many reactions it has
- `reactions` (object): How many of each reaction, keyed by the reaction
- `renote` (object): For a renote or quote, the note it shares
- `renoteCount` (number): How many times it was renoted
- `renoteId` (text): The note this one renotes or quotes
- `repliesCount` (number): How many replies it has
- `reply` (object): For a reply, the note it answers
- `replyId` (text): The note this one replies to
- `tags` (list): The hashtags in it, without '#'
- `text` (text): The text; empty for a plain renote
- `uri` (text): For a note from another server, its address there
- `url` (text): For a note from another server, its page there
- `user` (object): The author
- `userId` (text): The author's account ID
- `visibility` (text): public, home, followers or specified

**Example output**

```json
{
  "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 (`query`, text, required): The words to look for.
- Only notes by (`user`, text): Keep only notes by this account: a handle, a profile link or an account ID.
- Only this server's notes (`this_server_only`, true/false): Leave out notes from other servers.
- How many (`limit`, number): How many to return, up to 100. Misskey returns 10 when this is empty. From 1 to 100.
- Older than (ID) (`until_id`, text): Return only results older than this ID. Pass the previous step's 'oldest_id' to read the next page.

**Outputs**: The notes that matched

- `count` (number): How many came back
- `newest_id` (text): Pass as 'Newer than (ID)' to read what arrives next
- `notes` (list): The notes that matched
- `oldest_id` (text): Pass as 'Older than (ID)' to read the next, older page
- `query` (text): What was searched for

**Example output**

```json
{
  "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 (`user`, text, required): 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_requested` (true/false): True when the account is locked and must approve the follow
- `host` (text): The account's server; empty for this server
- `is_followed_by_them` (true/false): Whether it follows you
- `is_following` (true/false): Whether you now follow it
- `user` (object): An account
- `user_id` (text): The account's ID
- `username` (text): The account's username

**Example output**

```json
{
  "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 (`file`, text, required): Upload a file, pick one from an earlier step, or paste a link to a public PNG, JPEG or WebP image.
- File name (`name`, text): Defaults to the uploaded file's own name.
- Caption (`caption`, text): Describes the file for people using screen readers. Up to 512 characters.
- Mark as sensitive (`sensitive`, true/false): Hide the file behind a click-to-view wherever it appears.

**Outputs**: A file in the account's drive

- `comment` (text): The caption (alt text)
- `createdAt` (text): When it was uploaded (ISO 8601)
- `id` (text): The file's ID, for 'Files to attach'
- `isSensitive` (true/false): Whether it is hidden behind a click-to-view
- `name` (text): The file name
- `size` (number): Size in bytes
- `thumbnailUrl` (text): Link to a thumbnail, for images
- `type` (text): The media type, such as image/png
- `url` (text): Link to the file

**Example output**

```json
{
  "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"
}
```
