खोज केवल इस्तेमाल करने पर लोड होती है। नीचे सभी श्रेणियाँ देखें।

MCP टूल

प्रोजेक्ट प्रोफ़ाइल अपडेट करें

sosoapi_update_project_profile

प्रोजेक्ट की ब्रांड प्रोफ़ाइल के फ़ील्ड आंशिक रूप से अपडेट करें। छोड़े गए फ़ील्ड अपरिवर्तित रहते हैं। सबसे हाल में पढ़ा गया expected_profile_version और idempotency_key चाहिए (editor भूमिका)।

Markdown में पढ़ें

प्रोफ़ाइल और ट्रांसपोर्ट

प्रोफ़ाइल: full · ट्रांसपोर्ट: stdio, http

क्लाइंट में दिखने वाले टूल के लिए core या full चुनें; इससे अनुमतियाँ नहीं बदलतीं। लोकल फ़ाइल अपलोड के लिए stdio चाहिए और HTTP पर उपलब्ध नहीं। खोज में आउटपुट स्कीमा के लिए SOSOAPI_OUTPUT_SCHEMAS=1 सेट करें। इस सेटिंग के साथ या बिना टूल संरचित परिणाम लौटाते हैं।

अनुमतियाँ और अन्य प्रभाव

एनोटेशन क्लाइंट को टूल का वर्णन करने में मदद करते हैं। हर कॉल फिर भी यूज़र का प्रमाणीकरण, भूमिका, संसाधन एक्सेस और क्षमता अधिकार जाँचती है।

{
  "readOnlyHint": false,
  "destructiveHint": false,
  "idempotentHint": true,
  "openWorldHint": false
}

इनपुट फ़ील्ड

Required का अर्थ पैरेंट ऑब्जेक्ट और चुनी शाखा के भीतर अनिवार्य है। अनिवार्य चाइल्ड से वैकल्पिक पैरेंट अनिवार्य नहीं होता। नीचे के नियम और फ़ील्ड नाम कॉन्ट्रैक्ट से लिए गए हैं।

इनपुट फ़ील्ड
फ़ील्ड / शाखाप्रकार / अनिवार्यशर्तें
$objectपैरेंट में अनिवार्य
  • additionalProperties: false
project_idstringपैरेंट में अनिवार्य
  • format: "uuid"
expected_profile_versionintegerपैरेंट में अनिवार्य
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
idempotency_keystringपैरेंट में अनिवार्य
  • minLength: 8
  • maxLength: 160
patchobjectपैरेंट में अनिवार्य
  • additionalProperties: false
patch.taglinestring | nullवैकल्पिक / आइटम—
patch.taglineanyOf 1stringवैकल्पिक / आइटम
  • maxLength: 300
patch.taglineanyOf 2nullवैकल्पिक / आइटम—
patch.descriptionstring | nullवैकल्पिक / आइटम—
patch.descriptionanyOf 1stringवैकल्पिक / आइटम
  • maxLength: 4000
patch.descriptionanyOf 2nullवैकल्पिक / आइटम—
patch.voicestring | nullवैकल्पिक / आइटम—
patch.voiceanyOf 1stringवैकल्पिक / आइटम
  • maxLength: 1000
patch.voiceanyOf 2nullवैकल्पिक / आइटम—
patch.target_audiencestring | nullवैकल्पिक / आइटम—
patch.target_audienceanyOf 1stringवैकल्पिक / आइटम
  • maxLength: 1000
patch.target_audienceanyOf 2nullवैकल्पिक / आइटम—
patch.color_palettearrayवैकल्पिक / आइटम
  • maxItems: 20
patch.color_palette[]stringवैकल्पिक / आइटम
  • maxLength: 64
patch.goalsarrayवैकल्पिक / आइटम
  • maxItems: 50
patch.goals[]stringवैकल्पिक / आइटम
  • maxLength: 160
patch.no_go_topicsarrayवैकल्पिक / आइटम
  • maxItems: 100
patch.no_go_topics[]stringवैकल्पिक / आइटम
  • maxLength: 160
patch.language_primarystringवैकल्पिक / आइटम
  • minLength: 2
  • maxLength: 35
patch.positioningstring | nullवैकल्पिक / आइटम—
patch.positioninganyOf 1stringवैकल्पिक / आइटम
  • maxLength: 2000
patch.positioninganyOf 2nullवैकल्पिक / आइटम—
patch.uspstring | nullवैकल्पिक / आइटम—
patch.uspanyOf 1stringवैकल्पिक / आइटम
  • maxLength: 1000
patch.uspanyOf 2nullवैकल्पिक / आइटम—
patch.visual_identityobject | nullवैकल्पिक / आइटम—
patch.visual_identityanyOf 1objectवैकल्पिक / आइटम
  • additionalProperties: {}
patch.visual_identity.*anyOf 1any JSON valueवैकल्पिक / आइटम—
patch.visual_identityanyOf 2nullवैकल्पिक / आइटम—
patch.forbidden_claimsarrayवैकल्पिक / आइटम
  • maxItems: 100
patch.forbidden_claims[]stringवैकल्पिक / आइटम
  • maxLength: 240
patch.north_star_metricstring | nullवैकल्पिक / आइटम—
patch.north_star_metricanyOf 1stringवैकल्पिक / आइटम
  • maxLength: 300
patch.north_star_metricanyOf 2nullवैकल्पिक / आइटम—
patch.posting_cadenceobject | nullवैकल्पिक / आइटम—
patch.posting_cadenceanyOf 1objectवैकल्पिक / आइटम
  • additionalProperties: {}
patch.posting_cadence.*anyOf 1any JSON valueवैकल्पिक / आइटम—
patch.posting_cadenceanyOf 2nullवैकल्पिक / आइटम—
patch.app_store_url_iosstring | nullवैकल्पिक / आइटम—
patch.app_store_url_iosanyOf 1stringवैकल्पिक / आइटम
  • format: "uri"
patch.app_store_url_iosanyOf 2nullवैकल्पिक / आइटम—
patch.app_store_url_androidstring | nullवैकल्पिक / आइटम—
patch.app_store_url_androidanyOf 1stringवैकल्पिक / आइटम
  • format: "uri"
patch.app_store_url_androidanyOf 2nullवैकल्पिक / आइटम—
patch.app_metadataobjectवैकल्पिक / आइटम
  • additionalProperties: {}
patch.app_metadata.*any JSON valueवैकल्पिक / आइटम—
संपूर्ण JSON Schema
{
  "type": "object",
  "properties": {
    "project_id": {
      "type": "string",
      "format": "uuid"
    },
    "expected_profile_version": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "idempotency_key": {
      "type": "string",
      "minLength": 8,
      "maxLength": 160
    },
    "patch": {
      "type": "object",
      "properties": {
        "tagline": {
          "anyOf": [
            {
              "type": "string",
              "maxLength": 300
            },
            {
              "type": "null"
            }
          ]
        },
        "description": {
          "anyOf": [
            {
              "type": "string",
              "maxLength": 4000
            },
            {
              "type": "null"
            }
          ]
        },
        "voice": {
          "anyOf": [
            {
              "type": "string",
              "maxLength": 1000
            },
            {
              "type": "null"
            }
          ]
        },
        "target_audience": {
          "anyOf": [
            {
              "type": "string",
              "maxLength": 1000
            },
            {
              "type": "null"
            }
          ]
        },
        "color_palette": {
          "maxItems": 20,
          "type": "array",
          "items": {
            "type": "string",
            "maxLength": 64
          }
        },
        "goals": {
          "maxItems": 50,
          "type": "array",
          "items": {
            "type": "string",
            "maxLength": 160
          }
        },
        "no_go_topics": {
          "maxItems": 100,
          "type": "array",
          "items": {
            "type": "string",
            "maxLength": 160
          }
        },
        "language_primary": {
          "type": "string",
          "minLength": 2,
          "maxLength": 35
        },
        "positioning": {
          "anyOf": [
            {
              "type": "string",
              "maxLength": 2000
            },
            {
              "type": "null"
            }
          ]
        },
        "usp": {
          "anyOf": [
            {
              "type": "string",
              "maxLength": 1000
            },
            {
              "type": "null"
            }
          ]
        },
        "visual_identity": {
          "anyOf": [
            {
              "type": "object",
              "additionalProperties": {}
            },
            {
              "type": "null"
            }
          ]
        },
        "forbidden_claims": {
          "maxItems": 100,
          "type": "array",
          "items": {
            "type": "string",
            "maxLength": 240
          }
        },
        "north_star_metric": {
          "anyOf": [
            {
              "type": "string",
              "maxLength": 300
            },
            {
              "type": "null"
            }
          ]
        },
        "posting_cadence": {
          "anyOf": [
            {
              "type": "object",
              "additionalProperties": {}
            },
            {
              "type": "null"
            }
          ]
        },
        "app_store_url_ios": {
          "anyOf": [
            {
              "type": "string",
              "format": "uri"
            },
            {
              "type": "null"
            }
          ]
        },
        "app_store_url_android": {
          "anyOf": [
            {
              "type": "string",
              "format": "uri"
            },
            {
              "type": "null"
            }
          ]
        },
        "app_metadata": {
          "type": "object",
          "additionalProperties": {}
        }
      },
      "additionalProperties": false
    }
  },
  "required": [
    "project_id",
    "expected_profile_version",
    "idempotency_key",
    "patch"
  ],
  "additionalProperties": false
}

संरचित आउटपुट

यह स्कीमा सफल टूल परिणाम के structuredContent का वर्णन करता है। MCP रिस्पॉन्स में content भी होता है और कॉल विफल होने पर isError सेट हो सकता है। प्रकाशन के लिए स्वीकृत अनुरोध या टेक्स्ट रिस्पॉन्स को पुष्टि मानने के बजाय पोस्ट का अंतिम परिणाम पढ़ें। लिंक किया गया API ऑपरेशन अनुमतियाँ और पुनः प्रयास के नियम समझाता है।

Required का अर्थ पैरेंट ऑब्जेक्ट और चुनी शाखा के भीतर अनिवार्य है। अनिवार्य चाइल्ड से वैकल्पिक पैरेंट अनिवार्य नहीं होता। नीचे के नियम और फ़ील्ड नाम कॉन्ट्रैक्ट से लिए गए हैं।

संरचित आउटपुट
फ़ील्ड / शाखाप्रकार / अनिवार्यशर्तें
$objectपैरेंट में अनिवार्य
  • additionalProperties: false
contract_versionstringपैरेंट में अनिवार्य
  • const: "project/v1"
profileobjectपैरेंट में अनिवार्य
  • additionalProperties: false
profile.project_idstringपैरेंट में अनिवार्य
  • format: "uuid"
profile.workspace_idstringपैरेंट में अनिवार्य
  • format: "uuid"
profile.taglinestring | nullपैरेंट में अनिवार्य—
profile.taglineanyOf 1stringपैरेंट में अनिवार्य—
profile.taglineanyOf 2nullपैरेंट में अनिवार्य—
profile.descriptionstring | nullपैरेंट में अनिवार्य—
profile.descriptionanyOf 1stringपैरेंट में अनिवार्य—
profile.descriptionanyOf 2nullपैरेंट में अनिवार्य—
profile.voicestring | nullपैरेंट में अनिवार्य—
profile.voiceanyOf 1stringपैरेंट में अनिवार्य—
profile.voiceanyOf 2nullपैरेंट में अनिवार्य—
profile.target_audiencestring | nullपैरेंट में अनिवार्य—
profile.target_audienceanyOf 1stringपैरेंट में अनिवार्य—
profile.target_audienceanyOf 2nullपैरेंट में अनिवार्य—
profile.color_palettearrayपैरेंट में अनिवार्य—
profile.color_palette[]stringवैकल्पिक / आइटम—
profile.goalsarrayपैरेंट में अनिवार्य—
profile.goals[]stringवैकल्पिक / आइटम—
profile.no_go_topicsarrayपैरेंट में अनिवार्य—
profile.no_go_topics[]stringवैकल्पिक / आइटम—
profile.language_primarystringपैरेंट में अनिवार्य—
profile.positioningstring | nullपैरेंट में अनिवार्य—
profile.positioninganyOf 1stringपैरेंट में अनिवार्य—
profile.positioninganyOf 2nullपैरेंट में अनिवार्य—
profile.uspstring | nullपैरेंट में अनिवार्य—
profile.uspanyOf 1stringपैरेंट में अनिवार्य—
profile.uspanyOf 2nullपैरेंट में अनिवार्य—
profile.visual_identityobject | nullपैरेंट में अनिवार्य—
profile.visual_identityanyOf 1objectपैरेंट में अनिवार्य
  • additionalProperties: {}
profile.visual_identity.*anyOf 1any JSON valueवैकल्पिक / आइटम—
profile.visual_identityanyOf 2nullपैरेंट में अनिवार्य—
profile.forbidden_claimsarrayपैरेंट में अनिवार्य—
profile.forbidden_claims[]stringवैकल्पिक / आइटम—
profile.north_star_metricstring | nullपैरेंट में अनिवार्य—
profile.north_star_metricanyOf 1stringपैरेंट में अनिवार्य—
profile.north_star_metricanyOf 2nullपैरेंट में अनिवार्य—
profile.posting_cadenceobject | nullपैरेंट में अनिवार्य—
profile.posting_cadenceanyOf 1objectपैरेंट में अनिवार्य
  • additionalProperties: {}
profile.posting_cadence.*anyOf 1any JSON valueवैकल्पिक / आइटम—
profile.posting_cadenceanyOf 2nullपैरेंट में अनिवार्य—
profile.app_store_url_iosstring | nullपैरेंट में अनिवार्य—
profile.app_store_url_iosanyOf 1stringपैरेंट में अनिवार्य—
profile.app_store_url_iosanyOf 2nullपैरेंट में अनिवार्य—
profile.app_store_url_androidstring | nullपैरेंट में अनिवार्य—
profile.app_store_url_androidanyOf 1stringपैरेंट में अनिवार्य—
profile.app_store_url_androidanyOf 2nullपैरेंट में अनिवार्य—
profile.app_metadataobjectपैरेंट में अनिवार्य
  • additionalProperties: {}
profile.app_metadata.*any JSON valueवैकल्पिक / आइटम—
profile.profile_versionintegerपैरेंट में अनिवार्य
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
profile.updated_bystring | nullपैरेंट में अनिवार्य—
profile.updated_byanyOf 1stringपैरेंट में अनिवार्य
  • format: "uuid"
profile.updated_byanyOf 2nullपैरेंट में अनिवार्य—
profile.updated_by_kindstringपैरेंट में अनिवार्य
  • enum: ["jwt","api_key","delegated_ai","migration"]
profile.updated_by_api_key_idstring | nullपैरेंट में अनिवार्य—
profile.updated_by_api_key_idanyOf 1stringपैरेंट में अनिवार्य
  • format: "uuid"
profile.updated_by_api_key_idanyOf 2nullपैरेंट में अनिवार्य—
profile.updated_by_delegated_grant_idstring | nullपैरेंट में अनिवार्य—
profile.updated_by_delegated_grant_idanyOf 1stringपैरेंट में अनिवार्य
  • format: "uuid"
profile.updated_by_delegated_grant_idanyOf 2nullपैरेंट में अनिवार्य—
profile.created_atstringपैरेंट में अनिवार्य
  • format: "date-time"
  • pattern: "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
profile.updated_atstringपैरेंट में अनिवार्य
  • format: "date-time"
  • pattern: "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
receipt_idstringपैरेंट में अनिवार्य
  • format: "uuid"
appliedbooleanपैरेंट में अनिवार्य—
dedupedbooleanपैरेंट में अनिवार्य—
संपूर्ण JSON Schema
{
  "type": "object",
  "properties": {
    "contract_version": {
      "type": "string",
      "const": "project/v1"
    },
    "profile": {
      "type": "object",
      "properties": {
        "project_id": {
          "type": "string",
          "format": "uuid"
        },
        "workspace_id": {
          "type": "string",
          "format": "uuid"
        },
        "tagline": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "description": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "voice": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "target_audience": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "color_palette": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "goals": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "no_go_topics": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "language_primary": {
          "type": "string"
        },
        "positioning": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "usp": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "visual_identity": {
          "anyOf": [
            {
              "type": "object",
              "propertyNames": {
                "type": "string"
              },
              "additionalProperties": {}
            },
            {
              "type": "null"
            }
          ]
        },
        "forbidden_claims": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "north_star_metric": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "posting_cadence": {
          "anyOf": [
            {
              "type": "object",
              "propertyNames": {
                "type": "string"
              },
              "additionalProperties": {}
            },
            {
              "type": "null"
            }
          ]
        },
        "app_store_url_ios": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "app_store_url_android": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "app_metadata": {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {}
        },
        "profile_version": {
          "type": "integer",
          "exclusiveMinimum": 0,
          "maximum": 9007199254740991
        },
        "updated_by": {
          "anyOf": [
            {
              "type": "string",
              "format": "uuid"
            },
            {
              "type": "null"
            }
          ]
        },
        "updated_by_kind": {
          "type": "string",
          "enum": [
            "jwt",
            "api_key",
            "delegated_ai",
            "migration"
          ]
        },
        "updated_by_api_key_id": {
          "anyOf": [
            {
              "type": "string",
              "format": "uuid"
            },
            {
              "type": "null"
            }
          ]
        },
        "updated_by_delegated_grant_id": {
          "anyOf": [
            {
              "type": "string",
              "format": "uuid"
            },
            {
              "type": "null"
            }
          ]
        },
        "created_at": {
          "type": "string",
          "format": "date-time",
          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
        },
        "updated_at": {
          "type": "string",
          "format": "date-time",
          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
        }
      },
      "required": [
        "project_id",
        "workspace_id",
        "tagline",
        "description",
        "voice",
        "target_audience",
        "color_palette",
        "goals",
        "no_go_topics",
        "language_primary",
        "positioning",
        "usp",
        "visual_identity",
        "forbidden_claims",
        "north_star_metric",
        "posting_cadence",
        "app_store_url_ios",
        "app_store_url_android",
        "app_metadata",
        "profile_version",
        "updated_by",
        "updated_by_kind",
        "updated_by_api_key_id",
        "updated_by_delegated_grant_id",
        "created_at",
        "updated_at"
      ],
      "additionalProperties": false
    },
    "receipt_id": {
      "type": "string",
      "format": "uuid"
    },
    "applied": {
      "type": "boolean"
    },
    "deduped": {
      "type": "boolean"
    }
  },
  "required": [
    "contract_version",
    "profile",
    "receipt_id",
    "applied",
    "deduped"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

टूल कॉल का उदाहरण

उदाहरणों में स्कीमा से जाँचे काल्पनिक मान हैं। IDs को अधिकृत IDs, मीडिया को तैयार एसेट और तारीखों को पुष्ट प्रकाशन समय से बदलें। राइट सबमिट करने से पहले खाते की पात्रता जाँचें। यह पेज API अनुरोध नहीं भेजता।

{
  "name": "sosoapi_update_project_profile",
  "arguments": {
    "project_id": "11111111-1111-4111-8111-111111111111",
    "expected_profile_version": 1,
    "idempotency_key": "example-intent-0001",
    "patch": {
      "tagline": "A fictional project for the documentation example."
    }
  }
}

structuredContent

{
  "contract_version": "project/v1",
  "profile": {
    "project_id": "11111111-1111-4111-8111-111111111111",
    "workspace_id": "11111111-1111-4111-8111-111111111111",
    "tagline": null,
    "description": null,
    "voice": null,
    "target_audience": null,
    "color_palette": [],
    "goals": [],
    "no_go_topics": [],
    "language_primary": "example",
    "positioning": null,
    "usp": null,
    "visual_identity": null,
    "forbidden_claims": [],
    "north_star_metric": null,
    "posting_cadence": null,
    "app_store_url_ios": null,
    "app_store_url_android": null,
    "app_metadata": {},
    "profile_version": 1,
    "updated_by": null,
    "updated_by_kind": "jwt",
    "updated_by_api_key_id": null,
    "updated_by_delegated_grant_id": null,
    "created_at": "2099-01-15T09:00:00Z",
    "updated_at": "2099-01-15T09:00:00Z"
  },
  "receipt_id": "11111111-1111-4111-8111-111111111111",
  "applied": false,
  "deduped": false
}
MCP इंस्टॉल या कनेक्ट करें