MCP-verktyg

Uppdatera en sida med kontoomnämnanden

sosoapi_listening_mentions_refresh

Läs en avgränsad sida med plattformens egna Threads-omnämnanden med exakt kontobehörighet; återanvänd mutation_id för att undvika ny hämtning. Kräver agent:research.

Läs som Markdown

Profiler och transporter

Profiler: 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": false,
  "destructiveHint": false,
  "idempotentHint": true,
  "openWorldHint": true
}

/listening-api/mentions/refresh: agent:research · sparat kvitto för avgränsad läsning från plattformen och kontobunden omnämnandeprojektion; otillgängligt är inte ett lyckat tomt resultat

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 / gren	Typ / obligatoriskt	Begränsningar
`$`	`object`Obligatoriskt i överordnat objekt	`additionalProperties: false`
`workspace_id`	`string`Obligatoriskt i överordnat objekt	`format: "uuid"`
`social_account_id`	`string`Obligatoriskt i överordnat objekt	`format: "uuid"`
`mutation_id`	`string`Obligatoriskt i överordnat objekt	`format: "uuid"`
`after`	`string`Valfritt / objekt	`minLength: 1` `maxLength: 4096`
`limit`	`integer`Valfritt / objekt	`minimum: 1` `maximum: 100`

Fullständigt JSON Schema

{
  "type": "object",
  "properties": {
    "workspace_id": {
      "type": "string",
      "format": "uuid"
    },
    "social_account_id": {
      "type": "string",
      "format": "uuid"
    },
    "mutation_id": {
      "type": "string",
      "format": "uuid"
    },
    "after": {
      "type": "string",
      "minLength": 1,
      "maxLength": 4096
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "required": [
    "workspace_id",
    "social_account_id",
    "mutation_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.

Strukturerat resultat
Fält / gren	Typ / obligatoriskt	Begränsningar
`$`	`object`Obligatoriskt i överordnat objekt	`additionalProperties: false`
`refresh`	`object \| null`Obligatoriskt i överordnat objekt	—
`refresh`anyOf 1	`object`Obligatoriskt i överordnat objekt	`additionalProperties: false`
`refresh.id`anyOf 1	`string`Obligatoriskt i överordnat objekt	`format: "uuid"`
`refresh.workspace_id`anyOf 1	`string`Obligatoriskt i överordnat objekt	`format: "uuid"`
`refresh.social_account_id`anyOf 1	`string`Obligatoriskt i överordnat objekt	`format: "uuid"`
`refresh.mutation_id`anyOf 1	`string`Obligatoriskt i överordnat objekt	`format: "uuid"`
`refresh.state`anyOf 1	`string`Obligatoriskt i överordnat objekt	`enum: ["pending","running","completed","unavailable","cancelled","unconfirmed","expired"]`
`refresh.reason`anyOf 1	`string \| null`Obligatoriskt i överordnat objekt	—
`refresh.reason`anyOf 1 / anyOf 1	`string`Obligatoriskt i överordnat objekt	`enum: ["connection_unavailable","connection_changed","provider_denied","provider_rate_limited","provider_unavailable","provider_response_invalid","cancelled","deadline_exceeded","content_expired"]`
`refresh.reason`anyOf 1 / anyOf 2	`null`Obligatoriskt i överordnat objekt	—
`refresh.created_at`anyOf 1	`string`Obligatoriskt i överordnat objekt	`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)))$"`
`refresh.settled_at`anyOf 1	`string \| null`Obligatoriskt i överordnat objekt	—
`refresh.settled_at`anyOf 1 / anyOf 1	`string`Obligatoriskt i överordnat objekt	`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)))$"`
`refresh.settled_at`anyOf 1 / anyOf 2	`null`Obligatoriskt i överordnat objekt	—
`refresh.last_checked_at`anyOf 1	`string \| null`Obligatoriskt i överordnat objekt	—
`refresh.last_checked_at`anyOf 1 / anyOf 1	`string`Obligatoriskt i överordnat objekt	`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)))$"`
`refresh.last_checked_at`anyOf 1 / anyOf 2	`null`Obligatoriskt i överordnat objekt	—
`refresh.valid_until`anyOf 1	`string`Obligatoriskt i överordnat objekt	`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)))$"`
`refresh.item_count`anyOf 1	`integer`Obligatoriskt i överordnat objekt	`minimum: 0` `maximum: 100`
`refresh.next_native_cursor`anyOf 1	`string \| null`Obligatoriskt i överordnat objekt	—
`refresh.next_native_cursor`anyOf 1 / anyOf 1	`string`Obligatoriskt i överordnat objekt	`minLength: 1` `maxLength: 4096`
`refresh.next_native_cursor`anyOf 1 / anyOf 2	`null`Obligatoriskt i överordnat objekt	—
`refresh.coverage`anyOf 1	`string`Obligatoriskt i överordnat objekt	`const: "partial_native_page"`
`refresh.complete`anyOf 1	`boolean`Obligatoriskt i överordnat objekt	`const: false`
`refresh`anyOf 2	`null`Obligatoriskt i överordnat objekt	—
`items`	`array`Obligatoriskt i överordnat objekt	`maxItems: 100`
`items[]`	`object`Valfritt / objekt	`additionalProperties: false`
`items[].id`	`string`Obligatoriskt i överordnat objekt	`format: "uuid"`
`items[].workspace_id`	`string`Obligatoriskt i överordnat objekt	`format: "uuid"`
`items[].social_account_id`	`string`Obligatoriskt i överordnat objekt	`format: "uuid"`
`items[].provider_post_id`	`string`Obligatoriskt i överordnat objekt	`pattern: "^\\d{2,20}$"`
`items[].source`	`string`Obligatoriskt i överordnat objekt	`const: "threads"`
`items[].relationship`	`string`Obligatoriskt i överordnat objekt	`const: "account_mention"`
`items[].revision`	`integer`Obligatoriskt i överordnat objekt	`maximum: 9007199254740991` `exclusiveMinimum: 0`
`items[].handled`	`boolean`Obligatoriskt i överordnat objekt	—
`items[].archived`	`boolean`Obligatoriskt i överordnat objekt	—
`items[].availability`	`string`Obligatoriskt i överordnat objekt	`enum: ["available","expired","unavailable"]`
`items[].post`	`object \| null`Obligatoriskt i överordnat objekt	—
`items[].post`anyOf 1	`object`Obligatoriskt i överordnat objekt	`additionalProperties: false`
`items[].post.id`anyOf 1	`string`Obligatoriskt i överordnat objekt	`pattern: "^\\d{2,20}$"`
`items[].post.text`anyOf 1	`string \| null`Obligatoriskt i överordnat objekt	—
`items[].post.text`anyOf 1 / anyOf 1	`string`Obligatoriskt i överordnat objekt	`maxLength: 30000`
`items[].post.text`anyOf 1 / anyOf 2	`null`Obligatoriskt i överordnat objekt	—
`items[].post.username`anyOf 1	`string \| null`Obligatoriskt i överordnat objekt	—
`items[].post.username`anyOf 1 / anyOf 1	`string`Obligatoriskt i överordnat objekt	`pattern: "^[A-Za-z0-9._]{1,30}$"`
`items[].post.username`anyOf 1 / anyOf 2	`null`Obligatoriskt i överordnat objekt	—
`items[].post.permalink`anyOf 1	`string \| null`Obligatoriskt i överordnat objekt	—
`items[].post.permalink`anyOf 1 / anyOf 1	`string`Obligatoriskt i överordnat objekt	`format: "uri"`
`items[].post.permalink`anyOf 1 / anyOf 2	`null`Obligatoriskt i överordnat objekt	—
`items[].post.timestamp`anyOf 1	`string \| null`Obligatoriskt i överordnat objekt	—
`items[].post.timestamp`anyOf 1 / anyOf 1	`string`Obligatoriskt i överordnat objekt	`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)))$"`
`items[].post.timestamp`anyOf 1 / anyOf 2	`null`Obligatoriskt i överordnat objekt	—
`items[].post.media_type`anyOf 1	`string \| null`Obligatoriskt i överordnat objekt	—
`items[].post.media_type`anyOf 1 / anyOf 1	`string`Obligatoriskt i överordnat objekt	`enum: ["TEXT","TEXT_POST","IMAGE","VIDEO","CAROUSEL_ALBUM","AUDIO","REPOST_FACADE"]`
`items[].post.media_type`anyOf 1 / anyOf 2	`null`Obligatoriskt i överordnat objekt	—
`items[].post.is_reply`anyOf 1	`boolean \| null`Obligatoriskt i överordnat objekt	—
`items[].post.is_quote_post`anyOf 1	`boolean \| null`Obligatoriskt i överordnat objekt	—
`items[].post.has_replies`anyOf 1	`boolean \| null`Obligatoriskt i överordnat objekt	—
`items[].post.root_post_id`anyOf 1	`string \| null`Valfritt / objekt	—
`items[].post.root_post_id`anyOf 1 / anyOf 1	`string`Valfritt / objekt	`pattern: "^\\d{2,20}$"`
`items[].post.root_post_id`anyOf 1 / anyOf 2	`null`Valfritt / objekt	—
`items[].post.replied_to_id`anyOf 1	`string \| null`Valfritt / objekt	—
`items[].post.replied_to_id`anyOf 1 / anyOf 1	`string`Valfritt / objekt	`pattern: "^\\d{2,20}$"`
`items[].post.replied_to_id`anyOf 1 / anyOf 2	`null`Valfritt / objekt	—
`items[].post`anyOf 2	`null`Obligatoriskt i överordnat objekt	—
`items[].first_observed_at`	`string`Obligatoriskt i överordnat objekt	`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)))$"`
`items[].last_checked_at`	`string`Obligatoriskt i överordnat objekt	`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)))$"`
`items[].expires_at`	`string`Obligatoriskt i överordnat objekt	`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)))$"`
`items[].coverage`	`string`Obligatoriskt i överordnat objekt	`const: "partial_native_page"`

Fullständigt JSON Schema

{
  "type": "object",
  "properties": {
    "refresh": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "id": {
              "type": "string",
              "format": "uuid"
            },
            "workspace_id": {
              "type": "string",
              "format": "uuid"
            },
            "social_account_id": {
              "type": "string",
              "format": "uuid"
            },
            "mutation_id": {
              "type": "string",
              "format": "uuid"
            },
            "state": {
              "type": "string",
              "enum": [
                "pending",
                "running",
                "completed",
                "unavailable",
                "cancelled",
                "unconfirmed",
                "expired"
              ]
            },
            "reason": {
              "anyOf": [
                {
                  "type": "string",
                  "enum": [
                    "connection_unavailable",
                    "connection_changed",
                    "provider_denied",
                    "provider_rate_limited",
                    "provider_unavailable",
                    "provider_response_invalid",
                    "cancelled",
                    "deadline_exceeded",
                    "content_expired"
                  ]
                },
                {
                  "type": "null"
                }
              ]
            },
            "created_at": {
              "type": "string",
              "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)))$",
              "format": "date-time"
            },
            "settled_at": {
              "anyOf": [
                {
                  "type": "string",
                  "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)))$",
                  "format": "date-time"
                },
                {
                  "type": "null"
                }
              ]
            },
            "last_checked_at": {
              "anyOf": [
                {
                  "type": "string",
                  "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)))$",
                  "format": "date-time"
                },
                {
                  "type": "null"
                }
              ]
            },
            "valid_until": {
              "type": "string",
              "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)))$",
              "format": "date-time"
            },
            "item_count": {
              "type": "integer",
              "minimum": 0,
              "maximum": 100
            },
            "next_native_cursor": {
              "anyOf": [
                {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 4096
                },
                {
                  "type": "null"
                }
              ]
            },
            "coverage": {
              "type": "string",
              "const": "partial_native_page"
            },
            "complete": {
              "type": "boolean",
              "const": false
            }
          },
          "required": [
            "id",
            "workspace_id",
            "social_account_id",
            "mutation_id",
            "state",
            "reason",
            "created_at",
            "settled_at",
            "last_checked_at",
            "valid_until",
            "item_count",
            "next_native_cursor",
            "coverage",
            "complete"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    },
    "items": {
      "maxItems": 100,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "workspace_id": {
            "type": "string",
            "format": "uuid"
          },
          "social_account_id": {
            "type": "string",
            "format": "uuid"
          },
          "provider_post_id": {
            "type": "string",
            "pattern": "^\\d{2,20}$"
          },
          "source": {
            "type": "string",
            "const": "threads"
          },
          "relationship": {
            "type": "string",
            "const": "account_mention"
          },
          "revision": {
            "type": "integer",
            "exclusiveMinimum": 0,
            "maximum": 9007199254740991
          },
          "handled": {
            "type": "boolean"
          },
          "archived": {
            "type": "boolean"
          },
          "availability": {
            "type": "string",
            "enum": [
              "available",
              "expired",
              "unavailable"
            ]
          },
          "post": {
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string",
                    "pattern": "^\\d{2,20}$"
                  },
                  "text": {
                    "anyOf": [
                      {
                        "type": "string",
                        "maxLength": 30000
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "username": {
                    "anyOf": [
                      {
                        "type": "string",
                        "pattern": "^[A-Za-z0-9._]{1,30}$"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "permalink": {
                    "anyOf": [
                      {
                        "type": "string",
                        "format": "uri"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "timestamp": {
                    "anyOf": [
                      {
                        "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)))$"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "media_type": {
                    "anyOf": [
                      {
                        "type": "string",
                        "enum": [
                          "TEXT",
                          "TEXT_POST",
                          "IMAGE",
                          "VIDEO",
                          "CAROUSEL_ALBUM",
                          "AUDIO",
                          "REPOST_FACADE"
                        ]
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "is_reply": {
                    "type": [
                      "boolean",
                      "null"
                    ]
                  },
                  "is_quote_post": {
                    "type": [
                      "boolean",
                      "null"
                    ]
                  },
                  "has_replies": {
                    "type": [
                      "boolean",
                      "null"
                    ]
                  },
                  "root_post_id": {
                    "anyOf": [
                      {
                        "type": "string",
                        "pattern": "^\\d{2,20}$"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "replied_to_id": {
                    "anyOf": [
                      {
                        "type": "string",
                        "pattern": "^\\d{2,20}$"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  }
                },
                "required": [
                  "id",
                  "text",
                  "username",
                  "permalink",
                  "timestamp",
                  "media_type",
                  "is_reply",
                  "is_quote_post",
                  "has_replies"
                ],
                "additionalProperties": false
              },
              {
                "type": "null"
              }
            ]
          },
          "first_observed_at": {
            "type": "string",
            "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)))$",
            "format": "date-time"
          },
          "last_checked_at": {
            "type": "string",
            "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)))$",
            "format": "date-time"
          },
          "expires_at": {
            "type": "string",
            "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)))$",
            "format": "date-time"
          },
          "coverage": {
            "type": "string",
            "const": "partial_native_page"
          }
        },
        "required": [
          "id",
          "workspace_id",
          "social_account_id",
          "provider_post_id",
          "source",
          "relationship",
          "revision",
          "handled",
          "archived",
          "availability",
          "post",
          "first_observed_at",
          "last_checked_at",
          "expires_at",
          "coverage"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "refresh",
    "items"
  ],
  "$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_listening_mentions_refresh",
  "arguments": {
    "workspace_id": "11111111-1111-4111-8111-111111111111",
    "social_account_id": "11111111-1111-4111-8111-111111111111",
    "mutation_id": "11111111-1111-4111-8111-111111111111"
  }
}

structuredContent

{
  "refresh": null,
  "items": []
}

/listening-api/mentions/refresh

Installera eller anslut MCP

Integritetsinställningar

Nödvändiga funktioner

Valfri användningsanalys

Tillåt även sessionsinspelning på den här offentliga webbplatsen

Uppdatera en sida med kontoomnämnanden

Profiler och transporter

Behörigheter och sidoeffekter

Indatafält

Strukturerat resultat

Exempel på verktygsanrop

structuredContent

Uppdatera en sida med kontoomnämnanden

Profiler och transporter

Behörigheter och sidoeffekter

Indatafält

Strukturerat resultat

Exempel på verktygsanrop

structuredContent

Underliggande API-åtgärder