MinMaxHub
Documentation
  • Introduction
  • Architecture
  • Frontend
Domains
  • Nodes
  • Entities
  • Consensus
  • Suggestions
Resources
  • API Reference

Copyright 2026 MinMaxHub

  • Documentation
  • Domains
  • API Reference
Information
Consensus
    Trigger consensus recomputation for an entitypostApprove or reject a suggestion via moderationpostList suggestions pending moderationgetGet consensus page data for SSR renderinggetResolve a full page by slug pathget
Entities
    Create a new entity under a nodepostGet an entity by its unique identifiergetUpdate an entity's title and statusputDelete an entitydeleteRefresh an entity's layout from its parent node templatespatchList entities belonging to a nodegetGet an entity by its full slug pathgetList all entity slug pathsget
Media
    Get a presigned URL for image uploadpost
Nodes
    Create a new node in the taxonomy treepostGet a node by its unique identifiergetArchive a nodepatchUpdate a node's layout templatesputList ancestor nodes for a slug pathgetList direct children of a nodegetList all descendants of a nodegetGet a node by its slug pathget
Rules
    List all rules in a foldergetGet a single rule by folder and component keygetUpdate an existing ruleputCreate a new rulepost
Suggestions
    Create a new content suggestionpostGet a suggestion by its unique identifiergetSoft-delete a suggestiondeleteUpdate a suggestion's value or statuspatchList suggestions by a specific authorgetList suggestions for a specific entitygetList suggestions by target (entity + topic + item)get
Users
    List all usersgetGet a user profile by IDgetGet a user profile by usernameget
Votes
    Cast or change a vote on a suggestionpostGet the authenticated user's votesget
Schemas
powered by Zudoku
MinMaxHub API
MinMaxHub API

Users

Endpoint{apiBaseUrl}
Download schema

User profiles and account information. Email is never exposed publicly.


List all users

GET
{apiBaseUrl}
/users

Returns a paginated list of user profiles. Email is never included in the response. Requires authentication.

List all users › query Parameters

limit
​integer · min: 1

Maximum number of users to return per page

Default: 20
lastKey
​string

Encoded pagination key from a previous response

List all users › Responses

Users retrieved successfully

Standard response envelope wrapping all API responses. Every response includes a trace ID for debugging, a machine-readable status, and a human-readable message.
status
​string · enum · required

Machine-readable status code

Enum values:
OK
CREATED
ACCEPTED
NO_CONTENT
BAD_REQUEST
UNAUTHORIZED
FORBIDDEN
NOT_FOUND
message
​string · required

Human-readable status message

traceId
​string

Unique request trace ID for debugging and log correlation

​object

Paginated list of user profiles.

GET/users
curl --request GET \ --url %7BapiBaseUrl%7D/users
shell
Example Responses
No example specified for this content type
application/json

Get a user profile by ID

GET
{apiBaseUrl}
/users/{userId}

Retrieves a user's public profile by their unique identifier. Email is omitted from the response. Requires authentication.

Get a user profile by ID › path Parameters

userId
​string · uuid · required

Unique identifier of the user

Get a user profile by ID › Responses

User profile retrieved successfully

Standard response envelope wrapping all API responses. Every response includes a trace ID for debugging, a machine-readable status, and a human-readable message.
status
​string · enum · required

Machine-readable status code

Enum values:
OK
CREATED
ACCEPTED
NO_CONTENT
BAD_REQUEST
UNAUTHORIZED
FORBIDDEN
NOT_FOUND
message
​string · required

Human-readable status message

traceId
​string

Unique request trace ID for debugging and log correlation

​object

Public user profile. Email is always omitted from API responses to protect user privacy.

GET/users/{userId}
curl --request GET \ --url %7BapiBaseUrl%7D/users/:userId
shell
Example Responses
{ "traceId": "req_usr001", "status": "OK", "message": "User retrieved", "data": { "userId": "d4e5f6a7-b8c9-0123-def0-123456789abc", "username": "dungeon_master_42", "photoUrl": "https://cdn.example.com/avatars/dm42.webp", "rank": "ADEPT", "bio": "Forever DM. Collector of mimics and bad puns.", "isActive": true, "createdAt": "2025-06-01T08:00:00Z", "updatedAt": "2026-02-10T14:30:00Z" } }
json
application/json

Get a user profile by username

GET
{apiBaseUrl}
/users/username/{username}

Retrieves a user's public profile by their username. Email is omitted from the response. Requires authentication.

Get a user profile by username › path Parameters

username
​string · required

Username of the user

Get a user profile by username › Responses

User profile retrieved successfully

Standard response envelope wrapping all API responses. Every response includes a trace ID for debugging, a machine-readable status, and a human-readable message.
status
​string · enum · required

Machine-readable status code

Enum values:
OK
CREATED
ACCEPTED
NO_CONTENT
BAD_REQUEST
UNAUTHORIZED
FORBIDDEN
NOT_FOUND
message
​string · required

Human-readable status message

traceId
​string

Unique request trace ID for debugging and log correlation

​object

Public user profile. Email is always omitted from API responses to protect user privacy.

GET/users/username/{username}
curl --request GET \ --url %7BapiBaseUrl%7D/users/username/:username
shell
Example Responses
No example specified for this content type
application/json

SuggestionsVotes