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

Zoeken wordt pas geladen wanneer je het gebruikt. Bekijk hieronder alle categorieën.

MCP-tool

Lokale afbeelding of video uploaden

sosoapi_upload_asset

Upload een lokale afbeelding of video naar de mediabibliotheek van een werkruimte en registreer deze als mediabestand. Alleen echte bestanden in PNG/JPEG/GIF/WebP/MP4/MOV/WebM/MKV/MPEG tot 500 MiB uit de werkmap, tijdelijke map, Pictures/Movies/Videos of SOSOAPI_UPLOAD_ROOTS worden geaccepteerd; bestanden en mappen waarvan de naam met een punt begint worden geweigerd. Geeft de media-id en URL voor Scheduled Post-media terug.

Lezen als Markdown

Profielen en transporten

Profielen: core, full · Transporten: stdio

Kies core of full om te bepalen welke tools je client ziet; dit verandert geen machtigingen. Lokale bestandsupload vereist stdio en is niet beschikbaar via HTTP. Stel SOSOAPI_OUTPUT_SCHEMAS=1 in om uitvoerschema's bij detectie op te nemen. Tools geven met en zonder die instelling gestructureerde resultaten terug.

Machtigingen en neveneffecten

Annotaties helpen clients een tool te beschrijven. Elke aanroep controleert nog steeds gebruikersauthenticatie, rol, resourcetoegang en verleende bevoegdheden.

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

Invoervelden

Verplicht betekent verplicht binnen het bovenliggende object en de gekozen variant. Een verplicht onderliggend veld maakt een optioneel bovenliggend object niet verplicht. Onderstaande regels en veldnamen zijn uit het contract gekopieerd.

Invoervelden
Veld / variantType / verplichtBeperkingen
$objectVerplicht in bovenliggend object—
workspace_idstringVerplicht in bovenliggend object
  • format: "uuid"
file_pathstringVerplicht in bovenliggend object
  • minLength: 1
idempotency_keystringVerplicht in bovenliggend object
  • minLength: 8
  • maxLength: 160
content_typestringOptioneel / item
  • minLength: 1
titlestringOptioneel / item
  • maxLength: 200
descriptionstringOptioneel / item
  • maxLength: 2000
tagsarrayOptioneel / item
  • maxItems: 50
tags[]stringOptioneel / item
  • maxLength: 64
metadataobjectOptioneel / item
  • additionalProperties: {}
metadata.*any JSON valueOptioneel / item—
Volledig JSON Schema
{
  "type": "object",
  "properties": {
    "workspace_id": {
      "type": "string",
      "format": "uuid"
    },
    "file_path": {
      "type": "string",
      "minLength": 1
    },
    "idempotency_key": {
      "type": "string",
      "minLength": 8,
      "maxLength": 160
    },
    "content_type": {
      "type": "string",
      "minLength": 1
    },
    "title": {
      "type": "string",
      "maxLength": 200
    },
    "description": {
      "type": "string",
      "maxLength": 2000
    },
    "tags": {
      "maxItems": 50,
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 64
      }
    },
    "metadata": {
      "type": "object",
      "additionalProperties": {}
    }
  },
  "required": [
    "workspace_id",
    "file_path",
    "idempotency_key"
  ]
}

Gestructureerde uitvoer

Dit schema beschrijft structuredContent in een geslaagd toolresultaat. Het MCP-antwoord bevat ook content en kan isError instellen wanneer een aanroep mislukt. Lees bij publiceren het definitieve berichtresultaat; beschouw een geaccepteerd verzoek of tekstantwoord niet als bevestiging. De gekoppelde API-bewerking beschrijft machtigingen en regels voor opnieuw proberen.

Verplicht betekent verplicht binnen het bovenliggende object en de gekozen variant. Een verplicht onderliggend veld maakt een optioneel bovenliggend object niet verplicht. Onderstaande regels en veldnamen zijn uit het contract gekopieerd.

Gestructureerde uitvoer
Veld / variantType / verplichtBeperkingen
$objectVerplicht in bovenliggend object
  • additionalProperties: false
assetobjectVerplicht in bovenliggend object
  • additionalProperties: false
asset.idinteger | stringVerplicht in bovenliggend object—
asset.idanyOf 1integerVerplicht in bovenliggend object
  • minimum: -9007199254740991
  • maximum: 9007199254740991
asset.idanyOf 2stringVerplicht in bovenliggend object—
asset.workspace_idstringVerplicht in bovenliggend object
  • format: "uuid"
asset.user_idstringVerplicht in bovenliggend object
  • format: "uuid"
asset.asset_typestringVerplicht in bovenliggend object
  • enum: ["text","image","video","audio"]
asset.asset_urlstring | nullVerplicht in bovenliggend object—
asset.asset_urlanyOf 1stringVerplicht in bovenliggend object—
asset.asset_urlanyOf 2nullVerplicht in bovenliggend object—
asset.preview_urlstring | nullOptioneel / item

Tijdelijke lees-URL met werkruimtetoestemming. Vernieuw via Asset lezen/weergeven na preview_expires_at; behoud asset_url als blijvende media-identiteit.

—
asset.preview_urlanyOf 1stringOptioneel / item
  • format: "uri"
asset.preview_urlanyOf 2nullOptioneel / item—
asset.preview_expires_atstring | nullOptioneel / item—
asset.preview_expires_atanyOf 1stringOptioneel / item
  • 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))$"
asset.preview_expires_atanyOf 2nullOptioneel / item—
asset.titlestring | nullVerplicht in bovenliggend object—
asset.titleanyOf 1stringVerplicht in bovenliggend object—
asset.titleanyOf 2nullVerplicht in bovenliggend object—
asset.descriptionstring | nullVerplicht in bovenliggend object—
asset.descriptionanyOf 1stringVerplicht in bovenliggend object—
asset.descriptionanyOf 2nullVerplicht in bovenliggend object—
asset.tagsarray | nullVerplicht in bovenliggend object—
asset.tagsanyOf 1arrayVerplicht in bovenliggend object—
asset.tags[]anyOf 1stringOptioneel / item—
asset.tagsanyOf 2nullVerplicht in bovenliggend object—
asset.metadataobject | nullVerplicht in bovenliggend object—
asset.metadataanyOf 1objectVerplicht in bovenliggend object
  • additionalProperties: {}
asset.metadata.*anyOf 1any JSON valueOptioneel / item—
asset.metadataanyOf 2nullVerplicht in bovenliggend object—
asset.sourcestring | nullOptioneel / item—
asset.sourceanyOf 1stringOptioneel / item—
asset.sourceanyOf 2nullOptioneel / item—
asset.source_metadataobject | nullOptioneel / item—
asset.source_metadataanyOf 1objectOptioneel / item
  • additionalProperties: {}
asset.source_metadata.*anyOf 1any JSON valueOptioneel / item—
asset.source_metadataanyOf 2nullOptioneel / item—
asset.created_atstringVerplicht in bovenliggend object—
asset.versionintegerOptioneel / item
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
dedupedbooleanVerplicht in bovenliggend object—
Volledig JSON Schema
{
  "type": "object",
  "properties": {
    "asset": {
      "type": "object",
      "properties": {
        "id": {
          "anyOf": [
            {
              "type": "integer",
              "minimum": -9007199254740991,
              "maximum": 9007199254740991
            },
            {
              "type": "string"
            }
          ]
        },
        "workspace_id": {
          "type": "string",
          "format": "uuid"
        },
        "user_id": {
          "type": "string",
          "format": "uuid"
        },
        "asset_type": {
          "type": "string",
          "enum": [
            "text",
            "image",
            "video",
            "audio"
          ]
        },
        "asset_url": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "preview_url": {
          "description": "Workspace-authorized temporary read URL. Refresh through Asset read/list after preview_expires_at; keep asset_url as persisted media identity.",
          "anyOf": [
            {
              "type": "string",
              "format": "uri"
            },
            {
              "type": "null"
            }
          ]
        },
        "preview_expires_at": {
          "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))$"
            },
            {
              "type": "null"
            }
          ]
        },
        "title": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "description": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "tags": {
          "anyOf": [
            {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            {
              "type": "null"
            }
          ]
        },
        "metadata": {
          "anyOf": [
            {
              "type": "object",
              "propertyNames": {
                "type": "string"
              },
              "additionalProperties": {}
            },
            {
              "type": "null"
            }
          ]
        },
        "source": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "source_metadata": {
          "anyOf": [
            {
              "type": "object",
              "propertyNames": {
                "type": "string"
              },
              "additionalProperties": {}
            },
            {
              "type": "null"
            }
          ]
        },
        "created_at": {
          "type": "string"
        },
        "version": {
          "type": "integer",
          "exclusiveMinimum": 0,
          "maximum": 9007199254740991
        }
      },
      "required": [
        "id",
        "workspace_id",
        "user_id",
        "asset_type",
        "asset_url",
        "title",
        "description",
        "tags",
        "metadata",
        "created_at"
      ],
      "additionalProperties": false
    },
    "deduped": {
      "type": "boolean"
    }
  },
  "required": [
    "asset",
    "deduped"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Voorbeeld van een toolaanroep

Deze voorbeelden gebruiken fictieve waarden die tegen de schema's zijn gecontroleerd. Vervang IDs door toegestane IDs, media door gereedstaande bestanden en datums door je bevestigde publicatietijd. Controleer accountgeschiktheid vóór een schrijfhandeling. Deze pagina verstuurt geen API-verzoeken.

{
  "name": "sosoapi_upload_asset",
  "arguments": {
    "workspace_id": "11111111-1111-4111-8111-111111111111",
    "file_path": "./example.png",
    "idempotency_key": "example-upload-001"
  }
}

structuredContent

{
  "asset": {
    "id": 0,
    "workspace_id": "11111111-1111-4111-8111-111111111111",
    "user_id": "11111111-1111-4111-8111-111111111111",
    "asset_type": "text",
    "asset_url": null,
    "title": null,
    "description": null,
    "tags": null,
    "metadata": null,
    "created_at": "example"
  },
  "deduped": false
}
Installeer of verbind MCP