Get an entity card
GET/api/v4/entities/card
Returns the detail card for a detected entity. The registering plugin is always told which user is asking. A lookup with post_id requires permission to read that post, and that check has already been made before the plugin is called. A bare type_id and value lookup describes built-in types such as mm:time, and asks a plugin whose matcher accepts the whole value. The plugin allows or refuses that caller, and the answer is not cached. A glossary term is not asked unless a matcher accepts it, and an unknown value is refused the same way. Cache mode does not grant access. A shared card stored for a post is the same for every reader of that post.
Feature-gated behind FeatureFlags.Entities / MM_FEATUREFLAGS_ENTITIES=true.
Permissions
Must be authenticated. A lookup with a post requires permission to read the post's channel. A lookup without a post is allowed when the registering plugin allows that caller. An invalid built-in value is rejected. A refused plugin card and a glossary term without a post are both forbidden. Minimum server version: 12.2
Request
Responses
- 200
- 400
- 401
- 403
- 404
Entity card retrieval successful
Invalid or missing parameters in URL or request body
No access token provided
Do not have appropriate permissions
Resource not found