v19

latestOpenAPI 3.0.0raw.githubusercontent.com2026-08-037759134.1 KB
threads

Send a text message to a thread

post/thread/{id}

Request body

type'status_change' | 'text' | 'thread_closure' | 'deleted' required

The type of message

bodystring

The actual message text. Only present for text message type

privateboolean

Whether the message is only visible to moderators. Only present for text message type

replying_tostring nullable

The ID of the message being replied to by this message. Only present for text message type

old_status'approved' | 'archived' | 'rejected' | 'draft' | 'unlisted' | 'processing' | 'withheld' | 'scheduled' | 'private' | 'unknown'

The old status of the project. Only present for status_change message type

new_status'approved' | 'archived' | 'rejected' | 'draft' | 'unlisted' | 'processing' | 'withheld' | 'scheduled' | 'private' | 'unknown'

The new status of the project. Only present for status_change message type

Example request

{
  "type": "status_change",
  "body": "This is the text of the message.",
  "replying_to": "SSTTUUVV",
  "old_status": "processing",
  "new_status": "approved"
}

Response

Expected response to a valid request

idstring required

The ID of the thread

type'project' | 'report' | 'direct_message' required
project_idstring nullable

The ID of the associated project if a project thread

report_idstring nullable

The ID of the associated report if a report thread

Example response

{
  "id": "WWXXYYZZ",
  "messages": [
    {
      "id": "MMNNOOPP",
      "author_id": "QQRRSSTT",
      "body": {
        "type": "status_change",
        "body": "This is the text of the message.",
        "replying_to": "SSTTUUVV",
        "old_status": "processing",
        "new_status": "approved"
      }
    }
  ],
  "members": [
    {
      "username": "my_user",
      "name": "My User",
      "bio": "My short biography",
      "payout_data": {
        "payout_wallet": "paypal",
        "payout_wallet_type": "email",
        "payout_address": "support@modrinth.com"
      },
      "id": "EEFFGGHH",
      "avatar_url": "https://avatars.githubusercontent.com/u/11223344?v=1",
      "role": "developer",
      "badges": 63,
      "auth_providers": [
        "github",
        "gitlab",
        "steam",
        "microsoft",
        "google",
        "discord"
      ]
    }
  ]
}