Misskey

Misskey role API

The role API from Misskey — 4 operation(s) for role.

GitHub OpenAPI

Operations 4

POST /roles/list roles/list #
POST /roles/notes roles/notes #
POST /roles/show roles/show #
POST /roles/users roles/users #

Documentation

📖
Documentation
https://misskey-hub.net/en/docs/for-developers/api/
📖
Authentication
https://misskey-hub.net/en/docs/for-developers/api/token/
📖
RateLimits
https://raw.githubusercontent.com/api-evangelist/misskey/refs/heads/main/rate-limits/misskey-rate-limits.yml

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/misskey/refs/heads/main/openapi/misskey-role-api-openapi.yml

SDKs

📦
GitHubRepository
https://github.com/misskey-dev/misskey

Other Resources

🔗
SDKs
https://github.com/misskey-dev/misskey.js
🔗
Plans
https://raw.githubusercontent.com/api-evangelist/misskey/refs/heads/main/plans/misskey-plans-pricing.yml
🔗
FinOps
https://raw.githubusercontent.com/api-evangelist/misskey/refs/heads/main/finops/misskey-finops.yml
🔗
JSONLDContext
https://raw.githubusercontent.com/api-evangelist/misskey/refs/heads/main/json-ld/misskey-context.jsonld
🔗
JSONLDDescription
https://raw.githubusercontent.com/api-evangelist/misskey/refs/heads/main/json-ld/misskey-api.jsonld
🔗
Vocabulary
https://raw.githubusercontent.com/api-evangelist/misskey/refs/heads/main/vocabulary/misskey-vocabulary.json
🔗
Tags
https://raw.githubusercontent.com/api-evangelist/misskey/refs/heads/main/vocabulary/misskey-tags.json

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/misskey-role-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

misskey-role-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  version: 2025.4.1-io.12b-fb6fbea074
  title: Misskey account Role API
servers:
- url: https://misskey.io/api
tags:
- name: role
paths:
  /roles/list:
    post:
      operationId: post___roles___list
      summary: roles/list
      description: 'No description provided.


        **Credential required**: *Yes* / **Permission**: *read:account*'
      externalDocs:
        description: Source code
        url: https://github.com/MisskeyIO/misskey/blob/io/packages/backend/src/server/api/endpoints/roles/list.ts
      tags:
      - role
      security:
      - bearerAuth: []
      responses:
        '200':
          description: OK (with results)
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  $ref: '#/components/schemas/Role'
        '400':
          description: Client error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                INVALID_PARAM:
                  value:
                    error:
                      message: Invalid param.
                      code: INVALID_PARAM
                      id: 3d81ceae-475f-4600-b2a8-2bc116157532
        '401':
          description: Authentication error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                CREDENTIAL_REQUIRED:
                  value:
                    error:
                      message: Credential required.
                      code: CREDENTIAL_REQUIRED
                      id: 1384574d-a912-4b81-8601-c7b1c4085df1
        '403':
          description: Forbidden error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                AUTHENTICATION_FAILED:
                  value:
                    error:
                      message: Authentication failed. Please ensure your token is correct.
                      code: AUTHENTICATION_FAILED
                      id: b0a7f5f8-dc2f-4171-b91f-de88ad238e14
        '418':
          description: I'm Ai
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                I_AM_AI:
                  value:
                    error:
                      message: You sent a request to Ai-chan, Misskey's showgirl, instead of the server.
                      code: I_AM_AI
                      id: 60c46cd1-f23a-46b1-bebe-5d2b73951a84
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                INTERNAL_ERROR:
                  value:
                    error:
                      message: Internal error occurred. Please contact us if the error persists.
                      code: INTERNAL_ERROR
                      id: 5d37dbcb-891e-41ca-a3d6-e690c97775ac
  /roles/notes:
    post:
      operationId: post___roles___notes
      summary: roles/notes
      description: 'No description provided.


        **Credential required**: *Yes* / **Permission**: *read:account*'
      externalDocs:
        description: Source code
        url: https://github.com/MisskeyIO/misskey/blob/io/packages/backend/src/server/api/endpoints/roles/notes.ts
      tags:
      - role
      security:
      - bearerAuth: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                roleId:
                  type: string
                  format: misskey:id
                limit:
                  type: integer
                  minimum: 1
                  maximum: 100
                  default: 10
                sinceId:
                  type: string
                  format: misskey:id
                untilId:
                  type: string
                  format: misskey:id
                sinceDate:
                  type: integer
                untilDate:
                  type: integer
                dimension:
                  type:
                  - integer
                  - 'null'
                  minimum: 0
              required:
              - roleId
      responses:
        '200':
          description: OK (with results)
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  $ref: '#/components/schemas/Note'
        '400':
          description: Client error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                NO_SUCH_ROLE:
                  value:
                    error:
                      message: No such role.
                      code: NO_SUCH_ROLE
                      id: eb70323a-df61-4dd4-ad90-89c83c7cf26e
                INVALID_PARAM:
                  value:
                    error:
                      message: Invalid param.
                      code: INVALID_PARAM
                      id: 3d81ceae-475f-4600-b2a8-2bc116157532
        '401':
          description: Authentication error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                CREDENTIAL_REQUIRED:
                  value:
                    error:
                      message: Credential required.
                      code: CREDENTIAL_REQUIRED
                      id: 1384574d-a912-4b81-8601-c7b1c4085df1
        '403':
          description: Forbidden error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                AUTHENTICATION_FAILED:
                  value:
                    error:
                      message: Authentication failed. Please ensure your token is correct.
                      code: AUTHENTICATION_FAILED
                      id: b0a7f5f8-dc2f-4171-b91f-de88ad238e14
        '418':
          description: I'm Ai
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                I_AM_AI:
                  value:
                    error:
                      message: You sent a request to Ai-chan, Misskey's showgirl, instead of the server.
                      code: I_AM_AI
                      id: 60c46cd1-f23a-46b1-bebe-5d2b73951a84
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                INTERNAL_ERROR:
                  value:
                    error:
                      message: Internal error occurred. Please contact us if the error persists.
                      code: INTERNAL_ERROR
                      id: 5d37dbcb-891e-41ca-a3d6-e690c97775ac
  /roles/show:
    post:
      operationId: post___roles___show
      summary: roles/show
      description: 'No description provided.


        **Credential required**: *No*'
      externalDocs:
        description: Source code
        url: https://github.com/MisskeyIO/misskey/blob/io/packages/backend/src/server/api/endpoints/roles/show.ts
      tags:
      - role
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                roleId:
                  type: string
                  format: misskey:id
              required:
              - roleId
      responses:
        '200':
          description: OK (with results)
          content:
            application/json:
              schema:
                type: object
                $ref: '#/components/schemas/Role'
        '400':
          description: Client error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                NO_SUCH_ROLE:
                  value:
                    error:
                      message: No such role.
                      code: NO_SUCH_ROLE
                      id: de5502bf-009a-4639-86c1-fec349e46dcb
                INVALID_PARAM:
                  value:
                    error:
                      message: Invalid param.
                      code: INVALID_PARAM
                      id: 3d81ceae-475f-4600-b2a8-2bc116157532
        '401':
          description: Authentication error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                CREDENTIAL_REQUIRED:
                  value:
                    error:
                      message: Credential required.
                      code: CREDENTIAL_REQUIRED
                      id: 1384574d-a912-4b81-8601-c7b1c4085df1
        '403':
          description: Forbidden error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                AUTHENTICATION_FAILED:
                  value:
                    error:
                      message: Authentication failed. Please ensure your token is correct.
                      code: AUTHENTICATION_FAILED
                      id: b0a7f5f8-dc2f-4171-b91f-de88ad238e14
        '418':
          description: I'm Ai
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                I_AM_AI:
                  value:
                    error:
                      message: You sent a request to Ai-chan, Misskey's showgirl, instead of the server.
                      code: I_AM_AI
                      id: 60c46cd1-f23a-46b1-bebe-5d2b73951a84
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                INTERNAL_ERROR:
                  value:
                    error:
                      message: Internal error occurred. Please contact us if the error persists.
                      code: INTERNAL_ERROR
                      id: 5d37dbcb-891e-41ca-a3d6-e690c97775ac
  /roles/users:
    post:
      operationId: post___roles___users
      summary: roles/users
      description: 'No description provided.


        **Credential required**: *No*'
      externalDocs:
        description: Source code
        url: https://github.com/MisskeyIO/misskey/blob/io/packages/backend/src/server/api/endpoints/roles/users.ts
      tags:
      - role
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                roleId:
                  type: string
                  format: misskey:id
                sinceId:
                  type: string
                  format: misskey:id
                untilId:
                  type: string
                  format: misskey:id
                limit:
                  type: integer
                  minimum: 1
                  maximum: 100
                  default: 10
              required:
              - roleId
      responses:
        '200':
          description: OK (with results)
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    id:
                      type: string
                      format: misskey:id
                    user:
                      type: object
                      $ref: '#/components/schemas/UserDetailed'
                  required:
                  - id
                  - user
        '400':
          description: Client error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                NO_SUCH_ROLE:
                  value:
                    error:
                      message: No such role.
                      code: NO_SUCH_ROLE
                      id: 30aaaee3-4792-48dc-ab0d-cf501a575ac5
                INVALID_PARAM:
                  value:
                    error:
                      message: Invalid param.
                      code: INVALID_PARAM
                      id: 3d81ceae-475f-4600-b2a8-2bc116157532
        '401':
          description: Authentication error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                CREDENTIAL_REQUIRED:
                  value:
                    error:
                      message: Credential required.
                      code: CREDENTIAL_REQUIRED
                      id: 1384574d-a912-4b81-8601-c7b1c4085df1
        '403':
          description: Forbidden error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                AUTHENTICATION_FAILED:
                  value:
                    error:
                      message: Authentication failed. Please ensure your token is correct.
                      code: AUTHENTICATION_FAILED
                      id: b0a7f5f8-dc2f-4171-b91f-de88ad238e14
        '418':
          description: I'm Ai
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                I_AM_AI:
                  value:
                    error:
                      message: You sent a request to Ai-chan, Misskey's showgirl, instead of the server.
                      code: I_AM_AI
                      id: 60c46cd1-f23a-46b1-bebe-5d2b73951a84
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                INTERNAL_ERROR:
                  value:
                    error:
                      message: Internal error occurred. Please contact us if the error persists.
                      code: INTERNAL_ERROR
                      id: 5d37dbcb-891e-41ca-a3d6-e690c97775ac
components:
  schemas:
    RolePolicies:
      type: object
      properties:
        gtlAvailable:
          type: boolean
        ltlAvailable:
          type: boolean
        canPublicNote:
          type: boolean
        canScheduleNote:
          type: boolean
        scheduleNoteLimit:
          type: integer
        scheduleNoteMaxDays:
          type: integer
        canInitiateConversation:
          type: boolean
        canCreateContent:
          type: boolean
        canUpdateContent:
          type: boolean
        canDeleteContent:
          type: boolean
        canPurgeAccount:
          type: boolean
        canUpdateAvatar:
          type: boolean
        canUpdateBanner:
          type: boolean
        mentionLimit:
          type: integer
        canInvite:
          type: boolean
        inviteLimit:
          type: integer
        inviteLimitCycle:
          type: integer
        inviteExpirationTime:
          type: integer
        canManageCustomEmojis:
          type: boolean
        canManageAvatarDecorations:
          type: boolean
        canSearchNotes:
          type: boolean
        canUseTranslator:
          type: boolean
        canUseDriveFileInSoundSettings:
          type: boolean
        canUseReaction:
          type: boolean
        canHideAds:
          type: boolean
        driveCapacityMb:
          type: integer
        maxFileSizeMb:
          type: integer
        alwaysMarkNsfw:
          type: boolean
        skipNsfwDetection:
          type: boolean
        canUpdateBioMedia:
          type: boolean
        pinLimit:
          type: integer
        antennaLimit:
          type: integer
        antennaNotesLimit:
          type: integer
        wordMuteLimit:
          type: integer
        webhookLimit:
          type: integer
        clipLimit:
          type: integer
        noteEachClipsLimit:
          type: integer
        userListLimit:
          type: integer
        userEachUserListsLimit:
          type: integer
        rateLimitFactor:
          type: integer
        avatarDecorationLimit:
          type: integer
        canImportAntennas:
          type: boolean
        canImportBlocking:
          type: boolean
        canImportFollowing:
          type: boolean
        canImportMuting:
          type: boolean
        canImportUserLists:
          type: boolean
        mutualLinkSectionLimit:
          type: integer
        mutualLinkLimit:
          type: integer
        chatAvailability:
          type: string
          enum:
          - available
          - readonly
          - unavailable
      required:
      - gtlAvailable
      - ltlAvailable
      - canPublicNote
      - canScheduleNote
      - scheduleNoteLimit
      - scheduleNoteMaxDays
      - canInitiateConversation
      - canCreateContent
      - canUpdateContent
      - canDeleteContent
      - canPurgeAccount
      - canUpdateAvatar
      - canUpdateBanner
      - mentionLimit
      - canInvite
      - inviteLimit
      - inviteLimitCycle
      - inviteExpirationTime
      - canManageCustomEmojis
      - canManageAvatarDecorations
      - canSearchNotes
      - canUseTranslator
      - canUseDriveFileInSoundSettings
      - canUseReaction
      - canHideAds
      - driveCapacityMb
      - maxFileSizeMb
      - alwaysMarkNsfw
      - skipNsfwDetection
      - canUpdateBioMedia
      - pinLimit
      - antennaLimit
      - antennaNotesLimit
      - wordMuteLimit
      - webhookLimit
      - clipLimit
      - noteEachClipsLimit
      - userListLimit
      - userEachUserListsLimit
      - rateLimitFactor
      - avatarDecorationLimit
      - canImportAntennas
      - canImportBlocking
      - canImportFollowing
      - canImportMuting
      - canImportUserLists
      - mutualLinkSectionLimit
      - mutualLinkLimit
      - chatAvailability
    RoleCondFormulaValueIsLocalOrRemote:
      type: object
      properties:
        id:
          type: string
        type:
          type: string
          enum:
          - isLocal
          - isRemote
      required:
      - id
      - type
    RoleCondFormulaLogics:
      type: object
      properties:
        id:
          type: string
        type:
          type: string
          enum:
          - and
          - or
        values:
          type: array
          items:
            $ref: '#/components/schemas/RoleCondFormulaValue'
      required:
      - id
      - type
      - values
    UserDetailed:
      oneOf:
      - type: object
        $ref: '#/components/schemas/UserDetailedNotMe'
      - type: object
        $ref: '#/components/schemas/MeDetailed'
    UserLite:
      type: object
      properties:
        id:
          type: string
          format: id
          example: xxxxxxxxxx
        name:
          type:
          - string
          - 'null'
          example: 藍
        username:
          type: string
          example: ai
        host:
          type:
          - string
          - 'null'
          example: misskey.example.com
          description: The local host is represented with `null`.
        avatarUrl:
          type:
          - string
          - 'null'
          format: url
        avatarBlurhash:
          type:
          - string
          - 'null'
        avatarDecorations:
          type: array
          items:
            type: object
            properties:
              id:
                type: string
                format: id
              angle:
                type: number
              flipH:
                type: boolean
              url:
                type: string
                format: url
              offsetX:
                type: number
              offsetY:
                type: number
            required:
            - id
            - url
        isBot:
          type: boolean
        isCat:
          type: boolean
        requireSigninToViewContents:
          type: boolean
        makeNotesFollowersOnlyBefore:
          type:
          - number
          - 'null'
        makeNotesHiddenBefore:
          type:
          - number
          - 'null'
        instance:
          type: object
          properties:
            name:
              type:
              - string
              - 'null'
            softwareName:
              type:
              - string
              - 'null'
            softwareVersion:
              type:
              - string
              - 'null'
            iconUrl:
              type:
              - string
              - 'null'
            faviconUrl:
              type:
              - string
              - 'null'
            themeColor:
              type:
              - string
              - 'null'
          required:
          - name
          - softwareName
          - softwareVersion
          - iconUrl
          - faviconUrl
          - themeColor
        emojis:
          type: object
          additionalProperties:
            type: string
        onlineStatus:
          type: string
          enum:
          - unknown
          - online
          - active
          - offline
        badgeRoles:
          type: array
          items:
            type: object
            properties:
              name:
                type: string
              iconUrl:
                type:
                - string
                - 'null'
              displayOrder:
                type: number
              behavior:
                type: string
            required:
            - name
            - iconUrl
            - displayOrder
      required:
      - id
      - name
      - username
      - host
      - avatarUrl
      - avatarBlurhash
      - avatarDecorations
      - emojis
      - onlineStatus
    DriveFolder:
      type: object
      properties:
        id:
          type: string
          format: id
          example: xxxxxxxxxx
        createdAt:
          type: string
          format: date-time
        name:
          type: string
        parentId:
          type:
          - string
          - 'null'
          format: id
          example: xxxxxxxxxx
        foldersCount:
          type: number
        filesCount:
          type: number
        parent:
          type:
          - object
          - 'null'
          anyOf:
          - $ref: '#/components/schemas/DriveFolder'
          - type: 'null'
      required:
      - id
      - createdAt
      - name
      - parentId
    RoleCondFormulaFollowersOrFollowingOrNotes:
      type: object
      properties:
        id:
          type: string
        type:
          type: string
          enum:
          - followersLessThanOrEq
          - followersMoreThanOrEq
          - followingLessThanOrEq
          - followingMoreThanOrEq
          - notesLessThanOrEq
          - notesMoreThanOrEq
        value:
          type: number
      required:
      - id
      - type
      - value
    RoleCondFormulaValueCreated:
      type: object
      properties:
        id:
          type: string
        type:
          type: string
          enum:
          - createdLessThan
          - createdMoreThan
        sec:
          type: number
      required:
      - id
      - type
      - sec
    RoleCondFormulaValueNot:
      type: object
      properties:
        id:
          type: string
        type:
          type: string
          enum:
          - not
        value:
          type: object
          $ref: '#/components/schemas/RoleCondFormulaValue'
      required:
      - id
      - type
      - value
    RoleLite:
      type: object
      properties:
        id:
          type: string
          format: id
          example: xxxxxxxxxx
        name:
          type: string
          example: New Role
        color:
          type:
          - string
          - 'null'
          example: '#000000'
        iconUrl:
          type:
          - string
          - 'null'
        description:
          type: string
        isModerator:
          type: boolean
          example: false
        isAdministrator:
          type: boolean
          example: false
        displayOrder:
          type: integer
          example: 0
      required:
      - id
      - name
      - color
      - iconUrl
      - description
      - isModerator
      - isAdministrator
      - displayOrder
    MeDetailed:
      type: object
      allOf:
      - type: object
        $ref: '#/components/schemas/UserLite'
      - type: object
        $ref: '#/components/schemas/UserDetailedNotMeOnly'
      - type: object
        $ref: '#/components/schemas/MeDetailedOnly'
    UserDetailedNotMe:
      type: object
      allOf:
      - type: object
        $ref: '#/components/schemas/UserLite'
      - type: object
        $ref: '#/components/schemas/UserDetailedNotMeOnly'
    Announcement:
      type: object
      properties:
        id:
          type: string
          format: id
          example: xxxxxxxxxx
        createdAt:
          type: string
          format: date-time
        updatedAt:
          type:
          - string
          - 'null'
          format: date-time
        text:
          type: string
        title:
          type: string
        imageUrl:
          type:
          - string
          - 'null'
        icon:
          type: string
          enum:
          - info
          - warning
          - error
          - success
        display:
          type: string
          enum:
          - dialog
          - normal
          - banner
        needConfirmationToRead:
          type: boolean
        needEnrollmentTutorialToRead:
          type: boolean
        forYou:
          type: boolean
        closeDuration:
          type: number
        displayOrder:
          type: number
        silence:
          type: boolean
        isRead:
          type: boolean
      required:
      - id
      - createdAt
      - updatedAt
      - text
      - title
      - imageUrl
      - icon
      - display
      - needConfirmationToRead
      - needEnrollmentTutorialToRead
      - forYou
      - closeDuration
      - displayOrder
      - silence
    Note:
      type: object
      properties:
        id:
          type: string
          format: id
          example: xxxxxxxxxx
        createdAt:
          type: string
          format: date-time
        deletedAt:
          type:
          - string
          - 'null'
          format: date-time
        text:
          type:
          - string
          - 'null'
        cw:
          type:
          - string
          - 'null'
        userId:
          type: string
          format: id
        user:
          type: object
          $ref: '#/components/schemas/UserLite'
        replyId:
          type:
          - string
          - 'null'
          format: id
          example: xxxxxxxxxx
        renoteId:
          type:
          - string
          - 'null'
          format: id
          example: xxxxxxxxxx
        reply:
          type:
          - object
          - 'null'
          anyOf:
          - $ref: '#/components/schemas/Note'
          - type: 'null'
        renote:
          type:
          - object
          - 'null'
          anyOf:
          - $ref: '#/components/schemas/Note'
          - type: 'null'
        isHidden:
          type: boolean
        visibility:
          type: string
          enum:
          - public
          - home
          - followers
          - specified
        mentions:
          type: array
          items:
            type: string
            format: id
        visibleUserIds:
          type: array
          items:
            type: string
            format: id
        fileIds:
          type: array
          items:
            type: string
            format: id
        files:
          type: array
          items:
            type: object
            $ref: '#/components/schemas/DriveFile'
        tags:
          type: array
          items:
            type: string
        poll:
          type:
          - object
          - 'null'
          properties:
            expiresAt:
              type:
              - string
              - 'null'
              format: date-time
            multiple:
              type: boolean
            choices:
              type: array
              items:
                type: object
                properties:
                  isVoted:
                    type: boolean
                  text:
                    type: string
                  votes:
                    type: number
                required:
                - isVoted
                - text
                - votes
          required:
          - multiple
          - choices
        emojis:
          type: object
          additionalProperties:
            anyOf:
            - type: string
        channelId:
          type:
          - string
          - 'null'
          format: id
          example: xxxxxxxxxx
        channel:
          type:
          - object
          - 'null'
          properties:
            id:
              type: string
            name:
              type: string
            color:
              type: string
            isSensitive:
              type: boolean
            allowRenoteToExternal:
              type: boolean
            userId:
              type:
              - string
              - 'null'
          required:
          - id
          - name
          - color
          - isSensitive
          - allowRenoteToExternal
          - userId
        localOnly:
          type: boolean
        dimension:
          type:
          - integer
          - 'null'
        reactionAcceptance:
          type:
          - string
          - 'null'
          enum:
          - likeOnly
          - likeOnlyForRemote
          - nonSensitiveOnly
          - nonSensitiveOnlyForLocalLikeOnlyForRemote
          - null
        reactionEmojis:
          type: object
          additionalProperties:
            anyOf:
            - type: string
        reactions:
          type: object
          additionalProperties:
            anyOf:
            - type: number
        reactionCount:
          type: number
        renoteCount:
          type: number
        repliesCount:
          type: number
        uri:
          type: string
        url:
          type: string
        reactionAndUserPairCache:
          type: array
          items:
            type: string
        clippedCount:
          type: number
        myReaction:
          type:
          - string
          - 'null'
      required:
      - id
      - createdAt
      - text
      - userId
      - user
      - visibility
      - reactionAcceptance
      - reactionEmojis
      - reactions
      - reactionCount
      - renoteCount
      - repliesCount
    Role:
      type: object
      allOf:
      - type: object
        $ref: '#/components/schemas/RoleLite'
      - type: object
        properties:
          createdAt:
            type: string
            format: date-time
          updatedAt:
            type: string
            format: date-time
          target:
            type: string
            enum:
            - manual
            - conditional
          condFormula:
            type: object
            $ref: '#/components/schemas/RoleCondFormulaValue'
          isPublic:
            type: boolean
            example: false
          isExplorable:
            type: boolean
            example: false
          asBadge:
            type: boolean
            example: false
          preserveAssignmentOnMoveAccount:
            type: boolean
            example: false
          badgeBehavior:
            type:
            - string
            - 'null'
          canEditMembersByModerator:
            type: boolean
            example: false
          policies:
  

# --- truncated at 32 KB (61 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/misskey/refs/heads/main/openapi/misskey-role-api-openapi.yml