SosoAPI
SV
EN繁中繁體中文（台灣）简体中文日本語한국어DeutschFrançaisEspañolPortuguês (Brasil)العربيةעבריתNederlandsहिन्दीBahasa IndonesiaNorsk bokmålSvenskaMagyar
Logga in

Sökningen laddas först när du använder den. Bläddra bland alla kategorier nedan.

MCP-verktyg

Lista publiceringar som kräver åtgärd

sosoapi_list_publication_attentions

Lista publiceringar i en arbetsyta som kräver åtgärd, filtrerade på status (open eller resolved) eller scheduled_post_id, med offsetbaserad sidindelning.

Läs som Markdown

Profiler och transporter

Profiler: core, full · Transporter: stdio, http

Välj core eller full för att styra vilka verktyg klienten ser; detta ändrar inte dess behörigheter. Lokal filuppladdning kräver stdio och är inte tillgänglig via HTTP. Ange SOSOAPI_OUTPUT_SCHEMAS=1 för att inkludera utdatascheman vid identifiering. Verktygen returnerar strukturerade resultat med eller utan inställningen.

Behörigheter och sidoeffekter

Annoteringar hjälper klienter att beskriva ett verktyg. Varje anrop kontrollerar fortfarande användarens autentisering, roll, resursåtkomst och tilldelade funktionsbehörigheter.

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

Indatafält

Obligatoriskt betyder obligatoriskt inom sitt överordnade objekt och vald gren. Ett obligatoriskt underfält gör inte ett valfritt överordnat objekt obligatoriskt. Regler och fältnamn nedan kopieras från kontraktet.

Indatafält
Fält / grenTyp / obligatorisktBegränsningar
$objectObligatoriskt i överordnat objekt
  • additionalProperties: false
workspace_idstringObligatoriskt i överordnat objekt
  • format: "uuid"
statusstringValfritt / objekt
  • enum: ["open","resolved"]
scheduled_post_idstringValfritt / objekt
  • pattern: "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
limitintegerValfritt / objekt
  • minimum: 1
  • maximum: 200
offsetintegerValfritt / objekt
  • minimum: 0
  • maximum: 10000
Fullständigt JSON Schema
{
  "type": "object",
  "properties": {
    "workspace_id": {
      "type": "string",
      "format": "uuid"
    },
    "status": {
      "type": "string",
      "enum": [
        "open",
        "resolved"
      ]
    },
    "scheduled_post_id": {
      "type": "string",
      "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 200
    },
    "offset": {
      "type": "integer",
      "minimum": 0,
      "maximum": 10000
    }
  },
  "required": [
    "workspace_id"
  ],
  "additionalProperties": false
}

Strukturerat resultat

Detta schema beskriver structuredContent i ett lyckat verktygsresultat. MCP-svaret innehåller även content och kan ange isError när ett anrop misslyckas. För publicering ska du läsa inläggets slutresultat i stället för att tolka en accepterad begäran eller ett textsvar som bekräftelse. Den länkade API-åtgärden förklarar behörigheter och regler för nya försök.

Obligatoriskt betyder obligatoriskt inom sitt överordnade objekt och vald gren. Ett obligatoriskt underfält gör inte ett valfritt överordnat objekt obligatoriskt. Regler och fältnamn nedan kopieras från kontraktet.

Strukturerat resultat
Fält / grenTyp / obligatorisktBegränsningar
$objectObligatoriskt i överordnat objekt
  • additionalProperties: false
attentionsarrayObligatoriskt i överordnat objekt
  • maxItems: 200
attentions[]objectValfritt / objekt
  • additionalProperties: false
attentions[].idstringObligatoriskt i överordnat objekt
  • format: "uuid"
attentions[].workspace_idstringObligatoriskt i överordnat objekt
  • format: "uuid"
attentions[].scheduled_post_idstringObligatoriskt i överordnat objekt
  • pattern: "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
attentions[].publication_attempt_idstring | nullObligatoriskt i överordnat objekt—
attentions[].publication_attempt_idanyOf 1stringObligatoriskt i överordnat objekt
  • format: "uuid"
attentions[].publication_attempt_idanyOf 2nullObligatoriskt i överordnat objekt—
attentions[].social_account_idstring | nullObligatoriskt i överordnat objekt—
attentions[].social_account_idanyOf 1stringObligatoriskt i överordnat objekt
  • format: "uuid"
attentions[].social_account_idanyOf 2nullObligatoriskt i överordnat objekt—
attentions[].platformstringObligatoriskt i överordnat objekt
  • enum: ["instagram","threads","facebook","youtube","x"]
attentions[].account_labelstringObligatoriskt i överordnat objekt—
attentions[].statusstringObligatoriskt i överordnat objekt
  • enum: ["open","resolved"]
attentions[].causestringObligatoriskt i överordnat objekt
  • enum: ["terminal_failure","missing_evidence","delete_failed","stuck_dispatch"]
attentions[].reason_codestringObligatoriskt i överordnat objekt
  • enum: ["publication_failed","delivery_evidence_pending","provider_delete_needs_review","delivery_delayed"]
attentions[].messagestringObligatoriskt i överordnat objekt
  • minLength: 1
  • maxLength: 500
attentions[].actionabilitystringObligatoriskt i överordnat objekt
  • enum: ["user_actionable","vic_handling","resolved"]
attentions[].available_actionsarrayObligatoriskt i överordnat objekt
  • maxItems: 1
attentions[].available_actions[]stringValfritt / objekt
  • enum: ["retry","delete"]
attentions[].opened_atstringObligatoriskt i överordnat objekt—
attentions[].first_observed_atstringObligatoriskt i överordnat objekt—
attentions[].last_observed_atstringObligatoriskt i överordnat objekt—
attentions[].resolved_atstring | nullObligatoriskt i överordnat objekt—
attentions[].resolved_atanyOf 1stringObligatoriskt i överordnat objekt—
attentions[].resolved_atanyOf 2nullObligatoriskt i överordnat objekt—
attentions[].created_atstringObligatoriskt i överordnat objekt—
attentions[].updated_atstringObligatoriskt i överordnat objekt—
next_offsetinteger | nullObligatoriskt i överordnat objekt—
next_offsetanyOf 1integerObligatoriskt i överordnat objekt
  • minimum: 0
  • maximum: 10000
next_offsetanyOf 2nullObligatoriskt i överordnat objekt—
returned_countintegerObligatoriskt i överordnat objekt
  • minimum: 0
  • maximum: 200
totalintegerObligatoriskt i överordnat objekt
  • minimum: 0
  • maximum: 9007199254740991
Fullständigt JSON Schema
{
  "type": "object",
  "properties": {
    "attentions": {
      "maxItems": 200,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "workspace_id": {
            "type": "string",
            "format": "uuid"
          },
          "scheduled_post_id": {
            "type": "string",
            "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
          },
          "publication_attempt_id": {
            "anyOf": [
              {
                "type": "string",
                "format": "uuid"
              },
              {
                "type": "null"
              }
            ]
          },
          "social_account_id": {
            "anyOf": [
              {
                "type": "string",
                "format": "uuid"
              },
              {
                "type": "null"
              }
            ]
          },
          "platform": {
            "type": "string",
            "enum": [
              "instagram",
              "threads",
              "facebook",
              "youtube",
              "x"
            ]
          },
          "account_label": {
            "type": "string"
          },
          "status": {
            "type": "string",
            "enum": [
              "open",
              "resolved"
            ]
          },
          "cause": {
            "type": "string",
            "enum": [
              "terminal_failure",
              "missing_evidence",
              "delete_failed",
              "stuck_dispatch"
            ]
          },
          "reason_code": {
            "type": "string",
            "enum": [
              "publication_failed",
              "delivery_evidence_pending",
              "provider_delete_needs_review",
              "delivery_delayed"
            ]
          },
          "message": {
            "type": "string",
            "minLength": 1,
            "maxLength": 500
          },
          "actionability": {
            "type": "string",
            "enum": [
              "user_actionable",
              "vic_handling",
              "resolved"
            ]
          },
          "available_actions": {
            "maxItems": 1,
            "type": "array",
            "items": {
              "type": "string",
              "enum": [
                "retry",
                "delete"
              ]
            }
          },
          "opened_at": {
            "type": "string"
          },
          "first_observed_at": {
            "type": "string"
          },
          "last_observed_at": {
            "type": "string"
          },
          "resolved_at": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "created_at": {
            "type": "string"
          },
          "updated_at": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "workspace_id",
          "scheduled_post_id",
          "publication_attempt_id",
          "social_account_id",
          "platform",
          "account_label",
          "status",
          "cause",
          "reason_code",
          "message",
          "actionability",
          "available_actions",
          "opened_at",
          "first_observed_at",
          "last_observed_at",
          "resolved_at",
          "created_at",
          "updated_at"
        ],
        "additionalProperties": false
      }
    },
    "next_offset": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0,
          "maximum": 10000
        },
        {
          "type": "null"
        }
      ]
    },
    "returned_count": {
      "type": "integer",
      "minimum": 0,
      "maximum": 200
    },
    "total": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "attentions",
    "next_offset",
    "returned_count",
    "total"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Exempel på verktygsanrop

Exemplen använder fiktiva värden som kontrollerats mot schemana. Ersätt ID:n med sådana du får använda, medier med färdiga mediefiler och datum med din bekräftade publiceringstid. Kontrollera kontots behörighet före en skrivning. Denna sida skickar inga API-anrop.

{
  "name": "sosoapi_list_publication_attentions",
  "arguments": {
    "workspace_id": "11111111-1111-4111-8111-111111111111"
  }
}

structuredContent

{
  "attentions": [],
  "next_offset": null,
  "returned_count": 0,
  "total": 0
}
Installera eller anslut MCP