How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Misskey role API

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

Misskey role API is one of 32 APIs that Misskey publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Role. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, authentication docs, a GitHub repository, and rate-limit docs.

This API exposes 4 operations across 4 paths, and defines 24 schemas. It is described by OpenAPI 3.2.0, at version 2025.4.1-io.12b-fb6fbea074.

Requests are made against a single base URL, https://misskey.io/api.

4 operations 4 paths 24 schemas 4 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
2025.4.1-io.12b-fb6fbea074
Server
https://misskey.io/api
Authentication
HTTP Bearer
Resource Areas
1

Authentication & Security 1

Misskey role API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (bearerAuth).

Paths & Operations 4

Across 4 paths, the API surfaces 4 operations — 4 POST. Each is listed below with its method, path, parameters, and response codes.

role 4
POST
/roles/list
roles/list
post___roles___list → 200400401403418500
POST
/roles/notes
roles/notes
post___roles___notes body → 200400401403418500
POST
/roles/show
roles/show
post___roles___show body → 200400401403418500
POST
/roles/users
roles/users
post___roles___users body → 200400401403418500

Schemas 24

The contract defines 24 schemas that model the data the API accepts and returns. The most detailed are UserDetailedNotMeOnly (49 properties), RolePolicies (49 properties), MeDetailedOnly (44 properties), Note (35 properties). Each schema is shown below with its type and property counts.

RolePolicies
object
49 properties 49 required
RoleCondFormulaValueIsLocalOrRemote
object
2 properties 2 required
RoleCondFormulaLogics
object
3 properties 3 required
UserDetailed
UserLite
object
16 properties 9 required
DriveFolder
object
7 properties 4 required
RoleCondFormulaFollowersOrFollowingOrNotes
object
3 properties 3 required
RoleCondFormulaValueCreated
object
3 properties 3 required
RoleCondFormulaValueNot
object
3 properties 3 required
RoleLite
object
8 properties 8 required
MeDetailed
object
UserDetailedNotMe
object
Announcement
object
15 properties 14 required
Note
object
35 properties 12 required
Role
object
PageBlock
object
Error
object
1 property 1 required
Page
object
20 properties 19 required
MeDetailedOnly
object
44 properties 41 required
RoleCondFormulaValue
object
RoleCondFormulaValueUserSettingBooleanSchema
object
2 properties 2 required
UserDetailedNotMeOnly
object
49 properties 34 required
DriveFile
object
17 properties 14 required
RoleCondFormulaValueAssignedRole
object
3 properties 3 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

misskey-role-api-openapi.yml Raw ↑

Other APIs Misskey publishes across the network.

Misskey account API
Misskey Admin API
Misskey antennas API
Misskey app API
Misskey auth API
Misskey Bubble Game API
Misskey channels API
Misskey charts API
Misskey clip API
Misskey clips API
Misskey drive API
Misskey Export Custom Emojis API
Where this information came from

This is an independent, third-party profile of Misskey role API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.