Ferramenta MCP
Obter status de importação de ativo
sosoapi_get_asset_import_statusConsulte uma importação por import_id. Para publicar, informe include_asset=true: um resultado ready inclui o id, o tipo e a asset_url estável do ativo registrado, evitando um get_asset separado. Ativos pendentes ou ausentes não podem ser agendados. Nunca use a URL de origem ou prévia como identidade da mídia. Se travar, consulte sosoapi_job_status com job_id; nunca inicie uma importação duplicada.
Ler como MarkdownPerfis e transportes
Perfis: core, full · Transportes: stdio, http
Escolha core ou full para controlar quais ferramentas seu cliente vê; isso não altera suas permissões. O envio de arquivos locais exige stdio e não está disponível por HTTP. Defina SOSOAPI_OUTPUT_SCHEMAS=1 para incluir schemas de saída na descoberta. As ferramentas retornam resultados estruturados com ou sem essa configuração.
Permissões e efeitos colaterais
As anotações ajudam os clientes a descrever uma ferramenta. Cada chamada ainda verifica autenticação, função, acesso a recursos e concessões de capacidades do usuário.
{
"readOnlyHint": true,
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": false
}- /assets-api/imports/status: agent:operate · synchronous_http_response
Campos de entrada
Obrigatório significa obrigatório dentro do objeto pai e da ramificação selecionada. Um filho obrigatório não torna obrigatório um pai opcional. As regras e nomes de campos abaixo são copiados do contrato.
| Campo / ramificação | Tipo / obrigatório | Restrições |
|---|---|---|
$ | objectObrigatório no objeto pai |
|
workspace_id | stringObrigatório no objeto pai |
|
import_id | stringObrigatório no objeto pai |
|
include_asset | booleanOpcional / item | — |
JSON Schema completo
{
"type": "object",
"properties": {
"workspace_id": {
"type": "string",
"format": "uuid"
},
"import_id": {
"type": "string",
"format": "uuid"
},
"include_asset": {
"type": "boolean"
}
},
"required": [
"workspace_id",
"import_id"
],
"additionalProperties": false
}Saída estruturada
Este schema descreve structuredContent em um resultado de ferramenta bem-sucedido. A resposta MCP também inclui content e pode definir isError quando uma chamada falha. Para publicações, consulte o resultado final do post em vez de tratar uma requisição aceita ou resposta de texto como confirmação. A operação de API vinculada explica as permissões e regras de repetição.
Obrigatório significa obrigatório dentro do objeto pai e da ramificação selecionada. Um filho obrigatório não torna obrigatório um pai opcional. As regras e nomes de campos abaixo são copiados do contrato.
| Campo / ramificação | Tipo / obrigatório | Restrições |
|---|---|---|
$ | objectObrigatório no objeto pai |
|
import | objectObrigatório no objeto pai |
|
import.id | stringObrigatório no objeto pai |
|
import.status | stringObrigatório no objeto pai |
|
import.job_id | string | nullObrigatório no objeto pai | — |
import.job_idanyOf 1 | stringObrigatório no objeto pai |
|
import.job_idanyOf 2 | nullObrigatório no objeto pai | — |
import.asset_id | integer | nullObrigatório no objeto pai | — |
import.asset_idanyOf 1 | integerObrigatório no objeto pai |
|
import.asset_idanyOf 2 | nullObrigatório no objeto pai | — |
import.completed_asset_id | integer | nullObrigatório no objeto pai | — |
import.completed_asset_idanyOf 1 | integerObrigatório no objeto pai |
|
import.completed_asset_idanyOf 2 | nullObrigatório no objeto pai | — |
import.asset_purged_at | string | nullObrigatório no objeto pai | — |
import.asset_purged_atanyOf 1 | stringObrigatório no objeto pai | — |
import.asset_purged_atanyOf 2 | nullObrigatório no objeto pai | — |
import.source_url | stringObrigatório no objeto pai |
|
import.final_url | string | nullObrigatório no objeto pai | — |
import.final_urlanyOf 1 | stringObrigatório no objeto pai |
|
import.final_urlanyOf 2 | nullObrigatório no objeto pai | — |
import.object_key | string | nullObrigatório no objeto pai | — |
import.object_keyanyOf 1 | stringObrigatório no objeto pai |
|
import.object_keyanyOf 2 | nullObrigatório no objeto pai | — |
import.content_type | string | nullObrigatório no objeto pai | — |
import.content_typeanyOf 1 | stringObrigatório no objeto pai |
|
import.content_typeanyOf 2 | nullObrigatório no objeto pai | — |
import.byte_size | integer | nullObrigatório no objeto pai | — |
import.byte_sizeanyOf 1 | integerObrigatório no objeto pai |
|
import.byte_sizeanyOf 2 | nullObrigatório no objeto pai | — |
import.content_sha256 | string | nullObrigatório no objeto pai | — |
import.content_sha256anyOf 1 | stringObrigatório no objeto pai |
|
import.content_sha256anyOf 2 | nullObrigatório no objeto pai | — |
import.media_probe | reference | nullObrigatório no objeto pai | — |
import.media_probeanyOf 1 | string | number | boolean | null | array | objectObrigatório no objeto pai | — |
import.media_probeanyOf 1 / anyOf 1 | stringObrigatório no objeto pai | — |
import.media_probeanyOf 1 / anyOf 2 | numberObrigatório no objeto pai | — |
import.media_probeanyOf 1 / anyOf 3 | booleanObrigatório no objeto pai | — |
import.media_probeanyOf 1 / anyOf 4 | nullObrigatório no objeto pai | — |
import.media_probeanyOf 1 / anyOf 5 | arrayObrigatório no objeto pai | — |
import.media_probe[]anyOf 1 / anyOf 5 | referenceOpcional / item |
|
import.media_probeanyOf 1 / anyOf 6 | objectObrigatório no objeto pai |
|
import.media_probe.*anyOf 1 / anyOf 6 | referenceOpcional / item |
|
import.media_probeanyOf 2 | nullObrigatório no objeto pai | — |
import.error_message | string | nullObrigatório no objeto pai | — |
import.error_messageanyOf 1 | stringObrigatório no objeto pai | — |
import.error_messageanyOf 2 | nullObrigatório no objeto pai | — |
import.created_at | stringObrigatório no objeto pai | — |
import.completed_at | string | nullObrigatório no objeto pai | — |
import.completed_atanyOf 1 | stringObrigatório no objeto pai | — |
import.completed_atanyOf 2 | nullObrigatório no objeto pai | — |
asset | object | nullOpcional / item | — |
assetanyOf 1 | objectOpcional / item |
|
asset.idanyOf 1 | integer | stringObrigatório no objeto pai | — |
asset.idanyOf 1 / anyOf 1 | integerObrigatório no objeto pai |
|
asset.idanyOf 1 / anyOf 2 | stringObrigatório no objeto pai | — |
asset.asset_typeanyOf 1 | stringObrigatório no objeto pai |
|
asset.asset_urlanyOf 1 | string | nullObrigatório no objeto pai | — |
asset.asset_urlanyOf 1 / anyOf 1 | stringObrigatório no objeto pai | — |
asset.asset_urlanyOf 1 / anyOf 2 | nullObrigatório no objeto pai | — |
assetanyOf 2 | nullOpcional / item | — |
JSON Schema completo
{
"type": "object",
"properties": {
"import": {
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid"
},
"status": {
"type": "string",
"enum": [
"queued",
"importing",
"needs_repair",
"ready",
"asset_purged",
"failed"
]
},
"job_id": {
"anyOf": [
{
"type": "string",
"format": "uuid"
},
{
"type": "null"
}
]
},
"asset_id": {
"anyOf": [
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"completed_asset_id": {
"anyOf": [
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"asset_purged_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"source_url": {
"type": "string",
"format": "uri"
},
"final_url": {
"anyOf": [
{
"type": "string",
"format": "uri"
},
{
"type": "null"
}
]
},
"object_key": {
"anyOf": [
{
"type": "string",
"minLength": 1
},
{
"type": "null"
}
]
},
"content_type": {
"anyOf": [
{
"type": "string",
"minLength": 1
},
{
"type": "null"
}
]
},
"byte_size": {
"anyOf": [
{
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"content_sha256": {
"anyOf": [
{
"type": "string",
"pattern": "^[0-9a-f]{64}$"
},
{
"type": "null"
}
]
},
"media_probe": {
"anyOf": [
{
"$ref": "#/definitions/__schema0"
},
{
"type": "null"
}
]
},
"error_message": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"created_at": {
"type": "string"
},
"completed_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"id",
"status",
"job_id",
"asset_id",
"completed_asset_id",
"asset_purged_at",
"source_url",
"final_url",
"object_key",
"content_type",
"byte_size",
"content_sha256",
"media_probe",
"error_message",
"created_at",
"completed_at"
],
"additionalProperties": false
},
"asset": {
"anyOf": [
{
"type": "object",
"properties": {
"id": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "string"
}
]
},
"asset_type": {
"type": "string",
"enum": [
"text",
"image",
"video",
"audio"
]
},
"asset_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"id",
"asset_type",
"asset_url"
],
"additionalProperties": false
},
{
"type": "null"
}
]
}
},
"required": [
"import"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"definitions": {
"__schema0": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "null"
},
{
"type": "array",
"items": {
"$ref": "#/definitions/__schema0"
}
},
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"$ref": "#/definitions/__schema0"
}
}
]
}
}
}Exemplo de chamada de ferramenta
Estes exemplos usam valores fictícios verificados conforme os schemas. Substitua os IDs por aqueles que você tem autorização para usar, a mídia por ativos prontos e as datas pelo horário de publicação confirmado. Confira a elegibilidade da conta antes de enviar uma gravação. Esta página não envia requisições de API.
{
"name": "sosoapi_get_asset_import_status",
"arguments": {
"workspace_id": "11111111-1111-4111-8111-111111111111",
"import_id": "11111111-1111-4111-8111-111111111111"
}
}structuredContent
{
"import": {
"id": "11111111-1111-4111-8111-111111111111",
"status": "queued",
"job_id": null,
"asset_id": null,
"completed_asset_id": null,
"asset_purged_at": null,
"source_url": "https://example.com/media.png",
"final_url": null,
"object_key": null,
"content_type": null,
"byte_size": null,
"content_sha256": null,
"media_probe": null,
"error_message": null,
"created_at": "example",
"completed_at": null
}
}