# Referência de ferramentas do SosoAPI MCP

URL canônica: https://sosoapi.ai/pt-br/docs/social-media-mcp-tools

Use esta referência para encontrar uma ferramenta e conferir os campos necessários. Ela abrange sosoapi 0.5.9: o perfil core tem 28 ferramentas locais e 27 por HTTP; full tem 106 locais e 105 por HTTP. Escolha core para tarefas cotidianas ou full para incluir administração. Ambos usam as mesmas permissões. As entradas são geradas a partir do servidor e do catálogo de capacidades; consulte tools/list do cliente conectado para saber quais ferramentas estão disponíveis.

## Comece pela tarefa e consulte a ferramenta

Reutilize os IDs de workspace e conta já selecionados. Para um post de imagem por URL, chame sosoapi_post_image_url uma vez e mantenha o ID de post retornado. Envie arquivos locais com sosoapi_upload_asset por stdio. Para texto, use sosoapi_create_scheduled_post com provider_payload do destino e media vazio.

Peça ao usuário para revisar conta, texto, mídia e horário antes do envio. OAuth concede acesso para executar ações; não aprova o conteúdo. Após agendar, consulte o resultado de publicação do mesmo post antes de informar sucesso ou repetir uma requisição de resultado incerto.

- [Configure Claude Code ou Codex](https://sosoapi.ai/pt-br/docs/claude-code-codex-social-publishing)

- [Roteiro de texto e imagem no Threads](https://sosoapi.ai/pt-br/docs/threads-api-publishing)

- [Matriz de capacidades das plataformas](https://sosoapi.ai/pt-br/docs/publishing-capabilities)

- [Baixar schemas e anotações exatos de entrada do core (JSON)](https://sosoapi.ai/mcp-tools.json)

## Como interpretar esta referência

O build conecta o servidor MCP real a um cliente em memória, lista suas ferramentas sem chamar handlers e combina os requisitos de rotas públicas. Uma projeção desatualizada faz o build da Landing falhar. As descrições de ferramentas mantêm o texto do contrato do servidor em inglês; os resumos de conclusão explicam as regras de rotas canônicas. O JSON preserva os requisitos completos das rotas. A tabela de entradas é um índice, não substitui o JSON Schema aninhado completo.

As anotações MCP são indicações para clientes, não garantias de aplicação nem de segurança. Participação no Workspace, concessões, função atual, consentimento do provedor, elegibilidade da conta e cotas continuam valendo na execução. Algumas consultas de contexto podem criar um Workspace inicial; consulte a descrição e readOnlyHint em vez de presumir que todo “get” seja apenas leitura. Ferramentas compostas listam requisitos de suas rotas principais e de compatibilidade; não chamam todas as rotas listadas em cada requisição.

- [sosoapi no npm](https://www.npmjs.com/package/sosoapi)

- [Official MCP Registry: ai.sosoapi/sosoapi (JSON)](https://registry.modelcontextprotocol.io/v0.1/servers/ai.sosoapi%2Fsosoapi/versions)

## sosoapi_bulk_create_scheduled_posts

Agende posts para várias contas em uma chamada (targets). A mídia exige asset_ids enviados/importados e prontos, com suas URLs canônicas. Cada destino tem sucesso ou falha de forma independente, informado em successes ou failures. Exige a capacidade de publicação.

- Transporte: stdio, http.

- Permissão exigida: agent:publish. Funções mínimas da rota: editor.

- Indicação de somente leitura: false. Indicação de idempotência: true. Indicação de mundo externo: true.

- Como conferir o resultado: Consulte o resultado final de publicação; um agendamento aceito ainda está pendente.

Entradas de nível superior; veja no JSON as regras e restrições aninhadas

| Entrada | Tipo | Obrigatório |

| --- | --- | --- |

| workspace_id | string | Sim |

| project_id | string \| null | Não |

| source_ref | object \| null | Não |

| targets | array (object) | Sim |

## sosoapi_cancel_scheduled_post

Cancele um post agendado ainda não publicado para que ele nunca seja enviado. Um post publicado é recusado, e um agente também não pode excluir conteúdo publicado: o usuário faz isso no app web. Exige expected_version.

- Transporte: stdio, http.

- Permissão exigida: agent:publish. Funções mínimas da rota: editor.

- Indicação de somente leitura: false. Indicação de idempotência: true. Indicação de mundo externo: true.

- Como conferir o resultado: Consulte o resultado final de publicação; um agendamento aceito ainda está pendente.

Entradas de nível superior; veja no JSON as regras e restrições aninhadas

| Entrada | Tipo | Obrigatório |

| --- | --- | --- |

| id | string | Sim |

| expected_version | integer | Sim |

## sosoapi_create_comment

Coloque na fila um comentário exato para um destino canônico de post ou comentário; o status não representa sucesso do provedor.

- Transporte: stdio, http.

- Permissão exigida: agent:engage. Funções mínimas da rota: editor.

- Indicação de somente leitura: false. Indicação de idempotência: true. Indicação de mundo externo: true.

- Como conferir o resultado: Consulte o resultado confirmado pela plataforma; uma ação na fila ainda está pendente.

Entradas de nível superior; veja no JSON as regras e restrições aninhadas

| Entrada | Tipo | Obrigatório |

| --- | --- | --- |

| workspace_id | string | Sim |

| social_account_id | string | Sim |

| target | object \| object | Sim |

| message | string | Sim |

| idempotency_key | string | Sim |

## sosoapi_create_scheduled_post

Agende uma conta em scheduled_at com provider_payload. A mídia exige asset_id pronto e URL canônica; para uma imagem de origem, use sosoapi_post_image_url. Informe local_scheduled_at com schedule_dst_disambiguation ou omita ambos. Exige publish, função editor e idempotency_key. Agendado não significa publicado: consulte o resultado.

- Transporte: stdio, http.

- Permissão exigida: agent:publish. Funções mínimas da rota: editor.

- Indicação de somente leitura: false. Indicação de idempotência: true. Indicação de mundo externo: true.

- Como conferir o resultado: Consulte o resultado final de publicação; um agendamento aceito ainda está pendente.

Entradas de nível superior; veja no JSON as regras e restrições aninhadas

| Entrada | Tipo | Obrigatório |

| --- | --- | --- |

| workspace_id | string | Sim |

| project_id | string \| null | Não |

| social_account_id | string | Sim |

| caption | string \| null | Não |

| hashtags | array (string) | Não |

| media | array (object) | Não |

| link_url | string \| null | Não |

| provider_payload | object \| object \| object \| object \| object | Sim |

| scheduled_at | string | Sim |

| display_timezone | string | Não |

| local_scheduled_at | string | Não |

| schedule_dst_disambiguation | "exact" \| "earlier" \| "later" | Não |

| expires_at | string \| null | Não |

| source_ref | object \| null | Não |

| automatic_retry_enabled | boolean | Não |

| idempotency_key | string | Sim |

## sosoapi_get_asset

Consulte um ativo por id: metadados e uma URL de prévia de curta duração.

- Transporte: stdio, http.

- Permissão exigida: agent:operate. Funções mínimas da rota: viewer.

- Indicação de somente leitura: true. Indicação de idempotência: true. Indicação de mundo externo: false.

- Como conferir o resultado: Leia a resposta síncrona.

Entradas de nível superior; veja no JSON as regras e restrições aninhadas

| Entrada | Tipo | Obrigatório |

| --- | --- | --- |

| workspace_id | string | Não |

| id | integer \| string | Sim |

| include_version | boolean | Não |

## sosoapi_get_asset_import_status

Consulte 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.

- Transporte: stdio, http.

- Permissão exigida: agent:operate. Funções mínimas da rota: viewer.

- Indicação de somente leitura: true. Indicação de idempotência: true. Indicação de mundo externo: false.

- Como conferir o resultado: Leia a resposta síncrona.

Entradas de nível superior; veja no JSON as regras e restrições aninhadas

| Entrada | Tipo | Obrigatório |

| --- | --- | --- |

| workspace_id | string | Sim |

| import_id | string | Sim |

| include_asset | boolean | Não |

## sosoapi_get_billing_status

Consulte o plano de cobrança, o estado de pagamento, as datas do ciclo atual e o uso de cotas do usuário (publicações bem-sucedidas, posts agendados pendentes, contas conectadas). Confira antes de grandes execuções de agendamento.

- Transporte: stdio, http.

- Permissão exigida: agent:operate. Funções mínimas da rota: contexto da conta; sem função fixa de Workspace.

- Indicação de somente leitura: true. Indicação de idempotência: true. Indicação de mundo externo: false.

- Como conferir o resultado: Leia a resposta síncrona.

## sosoapi_get_comment_action_status

Consulte o comprovante terminal sanitizado de uma ação direta em comentário.

- Transporte: stdio, http.

- Permissão exigida: agent:engage. Funções mínimas da rota: viewer.

- Indicação de somente leitura: true. Indicação de idempotência: true. Indicação de mundo externo: true.

- Como conferir o resultado: Consulte o resultado confirmado pela plataforma; uma ação na fila ainda está pendente.

Entradas de nível superior; veja no JSON as regras e restrições aninhadas

| Entrada | Tipo | Obrigatório |

| --- | --- | --- |

| workspace_id | string | Sim |

| action_id | string | Sim |

## sosoapi_get_organization_context

Consulte o mapa atual de suas Organizations, seus Workspaces e Channels com ids e funções. Use quando precisar de ids de Organization ou Channel. Para publicar no Workspace, reutilize um id de Workspace retornado; não consulte também o contexto do workspace.

- Transporte: stdio, http.

- Permissão exigida: agent:operate. Funções mínimas da rota: contexto da conta; sem função fixa de Workspace.

- Indicação de somente leitura: true. Indicação de idempotência: true. Indicação de mundo externo: false.

- Como conferir o resultado: Leia a resposta síncrona.

Entradas de nível superior; veja no JSON as regras e restrições aninhadas

| Entrada | Tipo | Obrigatório |

| --- | --- | --- |

| organization_id | string | Não |

## sosoapi_get_provider_insight_status

Consulte uma solicitação de insights (request_id): queued, processing, completed (com o resultado do provedor e a disponibilidade por métrica) ou failed.

- Transporte: stdio, http.

- Permissão exigida: agent:operate. Funções mínimas da rota: viewer.

- Indicação de somente leitura: true. Indicação de idempotência: true. Indicação de mundo externo: true.

- Como conferir o resultado: Consulte o resultado da plataforma ou o motivo da indisponibilidade.

Entradas de nível superior; veja no JSON as regras e restrições aninhadas

| Entrada | Tipo | Obrigatório |

| --- | --- | --- |

| workspace_id | string | Sim |

| request_id | string | Sim |

## sosoapi_get_scheduled_post

Consulte um post agendado por id: conteúdo, status, estado de entrega e resultados. Sua version é o valor necessário como expected_version para atualizar, publicar, repetir e cancelar.

- Transporte: stdio, http.

- Permissão exigida: agent:operate. Funções mínimas da rota: viewer.

- Indicação de somente leitura: true. Indicação de idempotência: true. Indicação de mundo externo: false.

- Como conferir o resultado: Leia a resposta síncrona.

Entradas de nível superior; veja no JSON as regras e restrições aninhadas

| Entrada | Tipo | Obrigatório |

| --- | --- | --- |

| id | string | Sim |

## sosoapi_get_scheduled_post_eligibility

Verificação prévia somente de leitura por destino. Inclua draft (caption, hashtags, scheduled_at, display_timezone, horário local/DST opcional) para verificar conteúdo/horário; include_quota=true adiciona um retrato consultivo do período. Envie/importe mídia e aguarde a prontidão primeiro. Sem draft, apenas conta/mídia são verificadas. Não reserva nada; create/dispatch verificam novamente limites e autoridade.

- Transporte: stdio, http.

- Permissão exigida: agent:operate. Funções mínimas da rota: viewer.

- Indicação de somente leitura: true. Indicação de idempotência: true. Indicação de mundo externo: false.

- Como conferir o resultado: Leia a resposta síncrona.

Entradas de nível superior; veja no JSON as regras e restrições aninhadas

| Entrada | Tipo | Obrigatório |

| --- | --- | --- |

| workspace_id | string | Sim |

| include_quota | boolean | Não |

| targets | array (object) | Sim |

## sosoapi_get_workspace_context

Liste os Workspaces dos quais o usuário conectado participa e qual está ativo. Use quando workspace_id for desconhecido; reutilize o contexto atual em vez de repetir ambas as consultas de contexto. O Workspace ativo informado corresponde à seleção feita por uma pessoa no app web, não a um padrão para suas chamadas: informe workspace_id explicitamente. Não é uma operação apenas de leitura: para uma conta sem Workspace, ela cria o primeiro.

- Transporte: stdio, http.

- Permissão exigida: agent:operate. Funções mínimas da rota: contexto da conta; sem função fixa de Workspace.

- Indicação de somente leitura: false. Indicação de idempotência: true. Indicação de mundo externo: false.

- Como conferir o resultado: Leia a resposta síncrona.

Entradas de nível superior; veja no JSON as regras e restrições aninhadas

| Entrada | Tipo | Obrigatório |

| --- | --- | --- |

| include_version | boolean | Não |

## sosoapi_get_x_usage

Consulte os créditos de publicação no X da Organization compartilhados por este Workspace. Exige workspace_id. Free recebe 10 uma vez; Pro recebe 100 por período de cobrança. Texto custa 1, texto com URL custa 10. text opcional informa seu custo. Isso consulta a cota armazenada e não chama a API do X.

- Transporte: stdio, http.

- Permissão exigida: agent:operate. Funções mínimas da rota: viewer.

- Indicação de somente leitura: true. Indicação de idempotência: true. Indicação de mundo externo: false.

- Como conferir o resultado: Leia a resposta síncrona.

Entradas de nível superior; veja no JSON as regras e restrições aninhadas

| Entrada | Tipo | Obrigatório |

| --- | --- | --- |

| workspace_id | string | Sim |

| text | string | Não |

## sosoapi_import_asset_url

Peça ao SosoAPI para baixar uma imagem ou um vídeo de uma URL pública http(s) para o armazenamento privado do Workspace como novo ativo. Retorna import_id; consulte sosoapi_get_asset_import_status periodicamente. Exige idempotency_key e a função editor.

- Transporte: stdio, http.

- Permissão exigida: agent:operate. Funções mínimas da rota: editor.

- Indicação de somente leitura: false. Indicação de idempotência: true. Indicação de mundo externo: true.

- Como conferir o resultado: Uma importação aceita está pendente; acompanhe a mesma importação até ready ou failed.

Entradas de nível superior; veja no JSON as regras e restrições aninhadas

| Entrada | Tipo | Obrigatório |

| --- | --- | --- |

| workspace_id | string | Sim |

| source_url | string | Sim |

| idempotency_key | string | Sim |

| expected_kind | "image" \| "video" | Não |

| title | string | Não |

| description | string | Não |

| tags | array (string) | Não |

## sosoapi_job_status

Consulte um job em segundo plano por job_id: status, tipo e mensagem de erro se tiver falhado.

- Transporte: stdio, http.

- Permissão exigida: agent:operate. Funções mínimas da rota: contexto da conta; sem função fixa de Workspace.

- Indicação de somente leitura: true. Indicação de idempotência: true. Indicação de mundo externo: false.

- Como conferir o resultado: Leia a resposta síncrona.

Entradas de nível superior; veja no JSON as regras e restrições aninhadas

| Entrada | Tipo | Obrigatório |

| --- | --- | --- |

| job_id | string | Sim |

## sosoapi_list_connected_accounts

Liste as contas sociais (Instagram, Threads, Facebook, YouTube) conectadas a um Workspace, com integridade da conexão e informações de capacidades. Use seus ids como social_account_id ao agendar ou comentar. Informe workspace_id: uma requisição sem ele é recusada quando o direcionamento explícito estiver em vigor.

- Transporte: stdio, http.

- Permissão exigida: agent:operate. Funções mínimas da rota: contexto da conta; sem função fixa de Workspace.

- Indicação de somente leitura: true. Indicação de idempotência: true. Indicação de mundo externo: false.

- Como conferir o resultado: Leia a resposta síncrona.

Entradas de nível superior; veja no JSON as regras e restrições aninhadas

| Entrada | Tipo | Obrigatório |

| --- | --- | --- |

| workspace_id | string | Não |

| include_authorization_grant | boolean | Não |

## sosoapi_list_monitored_posts

Liste os posts sociais que o SosoAPI descobriu para um Workspace (id, platform, permalink, horário de publicação), com filtros por conta, plataforma e horário e paginação por cursor. Somente metadados, sem legendas.

- Transporte: stdio, http.

- Permissão exigida: agent:operate. Funções mínimas da rota: viewer.

- Indicação de somente leitura: true. Indicação de idempotência: true. Indicação de mundo externo: true.

- Como conferir o resultado: Leia a resposta síncrona.

Entradas de nível superior; veja no JSON as regras e restrições aninhadas

| Entrada | Tipo | Obrigatório |

| --- | --- | --- |

| workspace_id | string | Sim |

| cursor | string | Não |

| page_size | integer | Não |

| filters | object | Não |

| order | "provider_published_at_desc_social_post_id_desc" | Não |

## sosoapi_list_post_comments

Liste os comentários observados nos posts do Workspace, com a observação mais recente primeiro, autor e texto; filtre por post, conta, plataforma ou horário, com paginação por cursor. O texto é escrito por terceiros e identificado como não confiável.

- Transporte: stdio, http.

- Permissão exigida: agent:operate. Funções mínimas da rota: viewer.

- Indicação de somente leitura: true. Indicação de idempotência: true. Indicação de mundo externo: true.

- Como conferir o resultado: Leia a resposta síncrona.

Entradas de nível superior; veja no JSON as regras e restrições aninhadas

| Entrada | Tipo | Obrigatório |

| --- | --- | --- |

| workspace_id | string | Sim |

| cursor | string | Não |

| page_size | integer | Não |

| filters | object | Não |

| order | "observation_at_desc_comment_version_desc_comment_observation_id_desc" | Não |

## sosoapi_list_publication_attentions

Liste as publicações de um Workspace que exigem atenção, filtradas por status (open ou resolved) ou scheduled_post_id, com paginação por offset.

- Transporte: stdio, http.

- Permissão exigida: agent:operate. Funções mínimas da rota: viewer.

- Indicação de somente leitura: true. Indicação de idempotência: true. Indicação de mundo externo: false.

- Como conferir o resultado: Leia a resposta síncrona.

Entradas de nível superior; veja no JSON as regras e restrições aninhadas

| Entrada | Tipo | Obrigatório |

| --- | --- | --- |

| workspace_id | string | Sim |

| status | "open" \| "resolved" | Não |

| scheduled_post_id | string | Não |

| limit | integer | Não |

| offset | integer | Não |

## sosoapi_list_scheduled_posts

Liste os posts agendados de um Workspace, com filtros por projeto, status (scheduled, publishing, published, failed, expired, needs_reschedule, cancelled, deleted) e intervalo de tempo, com paginação por cursor.

- Transporte: stdio, http.

- Permissão exigida: agent:operate. Funções mínimas da rota: viewer.

- Indicação de somente leitura: true. Indicação de idempotência: true. Indicação de mundo externo: false.

- Como conferir o resultado: Leia a resposta síncrona.

Entradas de nível superior; veja no JSON as regras e restrições aninhadas

| Entrada | Tipo | Obrigatório |

| --- | --- | --- |

| workspace_id | string | Sim |

| project_id | string | Não |

| status | "scheduled" \| "publishing" \| "published" \| "failed" \| "expired" \| "needs_reschedule" \| "cancelled" \| "deleted" | Não |

| scheduled_from | string | Não |

| scheduled_to | string | Não |

| limit | integer | Não |

| cursor | object | Não |

## sosoapi_post_image_url

Envie o post completo de imagem por URL uma vez, com media vazio. O backend o prepara e publica mesmo após desconexão. Retorna a publicação terminal se disponível em 35 segundos; caso contrário, um ID durável de post; nunca reenvie com nova chave. Exige as permissões operate e publish. Campos de horário local/DST devem ser informados juntos. import_id serve apenas para retomar clientes antigos.

- Transporte: stdio, http.

- Permissão exigida: agent:publish + agent:operate. Funções mínimas da rota: editor, viewer.

- Indicação de somente leitura: false. Indicação de idempotência: true. Indicação de mundo externo: true.

- Como conferir o resultado: Consulte o resultado final de publicação; um agendamento aceito ainda está pendente. Uma importação aceita está pendente; acompanhe a mesma importação até ready ou failed. Leia a resposta síncrona.

Entradas de nível superior; veja no JSON as regras e restrições aninhadas

| Entrada | Tipo | Obrigatório |

| --- | --- | --- |

| source_url | string | Sim |

| post | object | Sim |

| import_id | string | Não |

## sosoapi_publish_scheduled_post_now

Publique imediatamente um post agendado em vez de em scheduled_at. Público e irreversível; exige expected_version. Na fila não significa publicado: consulte o resultado.

- Transporte: stdio, http.

- Permissão exigida: agent:publish. Funções mínimas da rota: editor.

- Indicação de somente leitura: false. Indicação de idempotência: true. Indicação de mundo externo: true.

- Como conferir o resultado: Consulte o resultado final de publicação; um agendamento aceito ainda está pendente.

Entradas de nível superior; veja no JSON as regras e restrições aninhadas

| Entrada | Tipo | Obrigatório |

| --- | --- | --- |

| id | string | Sim |

| expected_version | integer | Sim |

## sosoapi_query_assets

Encontre ativos de um Workspace por asset_type, source ou tag; retorna uma página (limit até 100, mais offset) e o total. Informe workspace_id explicitamente.

- Transporte: stdio, http.

- Permissão exigida: agent:operate. Funções mínimas da rota: viewer.

- Indicação de somente leitura: true. Indicação de idempotência: true. Indicação de mundo externo: false.

- Como conferir o resultado: Leia a resposta síncrona.

Entradas de nível superior; veja no JSON as regras e restrições aninhadas

| Entrada | Tipo | Obrigatório |

| --- | --- | --- |

| workspace_id | string | Não |

| asset_type | "text" \| "image" \| "video" \| "audio" \| array ("text" \| "image" \| "video" \| "audio") | Não |

| source | string | Não |

| tag | string | Não |

| limit | integer | Não |

| offset | integer | Não |

| include_version | boolean | Não |

## sosoapi_request_provider_insights

Solicite ao provedor insights de uma conta ou post em um intervalo de datas opcional (até 366 dias). Retorna request_id e, quando em cache, o resultado; caso contrário, consulte sosoapi_get_provider_insight_status periodicamente.

- Transporte: stdio, http.

- Permissão exigida: agent:operate. Funções mínimas da rota: viewer.

- Indicação de somente leitura: false. Indicação de idempotência: false. Indicação de mundo externo: true.

- Como conferir o resultado: Consulte o resultado da plataforma ou o motivo da indisponibilidade.

Entradas de nível superior; veja no JSON as regras e restrições aninhadas

| Entrada | Tipo | Obrigatório |

| --- | --- | --- |

| workspace_id | string | Sim |

| social_account_id | string | Sim |

| resource_kind | "account" \| "post" | Sim |

| provider_resource_id | string | Não |

| start_date | string | Não |

| end_date | string | Não |

| include_audience | boolean | Não |

| refresh | boolean | Não |

## sosoapi_retry_scheduled_post

Tente novamente um post agendado que falhou, opcionalmente com novo scheduled_at. Exige expected_version.

- Transporte: stdio, http.

- Permissão exigida: agent:publish. Funções mínimas da rota: editor.

- Indicação de somente leitura: false. Indicação de idempotência: true. Indicação de mundo externo: true.

- Como conferir o resultado: Consulte o resultado final de publicação; um agendamento aceito ainda está pendente.

Entradas de nível superior; veja no JSON as regras e restrições aninhadas

| Entrada | Tipo | Obrigatório |

| --- | --- | --- |

| id | string | Sim |

| expected_version | integer | Sim |

| scheduled_at | string | Não |

## sosoapi_update_scheduled_post

Edite um post agendado que ainda não foi despachado (caption, hashtags, media, link, time). Exige expected_version da consulta mais recente; uma versão desatualizada é rejeitada.

- Transporte: stdio, http.

- Permissão exigida: agent:publish. Funções mínimas da rota: editor.

- Indicação de somente leitura: false. Indicação de idempotência: true. Indicação de mundo externo: true.

- Como conferir o resultado: Consulte o resultado final de publicação; um agendamento aceito ainda está pendente.

Entradas de nível superior; veja no JSON as regras e restrições aninhadas

| Entrada | Tipo | Obrigatório |

| --- | --- | --- |

| id | string | Sim |

| expected_version | integer | Sim |

| patch | object | Sim |

| provider_payload | object \| object \| object \| object \| object | Não |

## sosoapi_upload_asset

Envie um arquivo local de imagem ou vídeo para a biblioteca de ativos de um Workspace e registre-o como ativo. São aceitos apenas arquivos PNG/JPEG/GIF/WebP/MP4/MOV/WebM/MKV/MPEG reais de até 500 MiB do diretório de trabalho, pasta temporária, Pictures/Movies/Videos ou SOSOAPI_UPLOAD_ROOTS; arquivos e pastas iniciados por ponto são recusados. Retorna id e URL do ativo para mídia de Scheduled Post.

- Transporte: stdio.

- Permissão exigida: agent:operate. Funções mínimas da rota: editor.

- Indicação de somente leitura: false. Indicação de idempotência: true. Indicação de mundo externo: true.

- Como conferir o resultado: Leia a resposta síncrona.

Entradas de nível superior; veja no JSON as regras e restrições aninhadas

| Entrada | Tipo | Obrigatório |

| --- | --- | --- |

| workspace_id | string | Sim |

| file_path | string | Sim |

| idempotency_key | string | Sim |

| content_type | string | Não |

| title | string | Não |

| description | string | Não |

| tags | array (string) | Não |

| metadata | object | Não |