設定

アカウント設定の読み取り・更新と API キー管理を行うエンドポイントです。

GET/api/v1/settings

認証済みユーザーの現在の設定を取得します。

認証

settings:read

レスポンス

{
  "settings": {
    "isAcceptingQuestions": true,
    "target": "anyone",
    "allowAnonymous": true,
    "notifyOnMisskey": true,
    "primaryColor": "#7c3aed",
    "textColor": "#1f2937",
    "frameStyle": "default",
    "bio": "Hello!",
    "autoModeration": true,
    "moderationThresholds": null,
    "ngWords": [],
    "driveFolderPath": "mewk",
    "scheduledPostEnabled": false,
    "scheduledPostHours": [],
    "scheduledPostVisibility": "public",
    "scheduledPostLocalOnly": false,
    ...
  }
}
PUT/api/v1/settings

設定フィールドを 1 つ以上更新します。指定したフィールドのみ更新されます。

認証

settings:write

リクエストボディ

{
  "isAcceptingQuestions": true,
  "target": "anyone",
  "allowAnonymous": true,
  "acceptedQuestionTypes": ["normal", "request"],  // [] = all accepted
  "notifyOnMisskey": true,
  "frameStyle": "default",
  "primaryColor": "#7c3aed",
  "textColor": "#1f2937",
  "bio": "Hello!",  // MFM supported, max 500 chars
  "autoModeration": true,
  "moderationThresholds": null,  // null = システムデフォルト, or { "sexual": 0.8, "violence": 0.7, ... }
  "scheduledPostEnabled": false,
  "scheduledPostHours": [9, 18],
  "scheduledPostVisibility": "public",
  "scheduledPostLocalOnly": false      // local only (no federation)
}

リクエストボディに含まれないフィールドは変更されません。

GET/api/v1/settings/api-keys

認証済みユーザーのすべての API キーを一覧表示します(シークレット値は返されません)。

認証

認証必須(任意の有効な API キー)