Aprobar el video y su destino en TikTok

Registra el consentimiento de la persona autenticada para el video, texto, cuenta y opciones exactos que revisó.

Tool IDtiktok.publicacion.aprobar
Nombre MCPtiktok__publicacion__aprobar
Conectortiktok
Planoaction
Scope (permiso)tiktok:publish
Authnone
Versión1
Sensiblesí
Deprecadono
ComportamientoreadOnly=false, destructive=false, idempotent=true, openWorld=false

Requiere conexión. Indica cuál en cada llamada: header X-Connect-Connection en REST y campo connectionId en el execute_write de MCP. No hay resolución implícita, ni siquiera con una sola conexión activa: la conexión es la empresa. El id sale de conexiones.estado.consultar.

Qué hace

Exige sesión humana; una API key o agente no puede sustituir esta aprobación. No publica.

Entrada

CampoTipoRequeridoDescripción
mediaIdstringsí
mediaSha256string ^[a-f0-9]{64}$sí
creatorInfoSha256string ^[a-f0-9]{64}$sí
idempotencyKeystring `^([0-9a-fA-F]8-[0-9a-fA-F]4-[1-8][0-9a-fA-F]3-[89abAB][0-9a-fA-F]3-[0-9a-fA-F]1200000000-0000-0000-0000-000000000000ffffffff-ffff-ffff-ffff-ffffffffffff)$`
titlestringsí
choicesobjetosí
choices.privacy"PUBLIC_TO_EVERYONE" · "MUTUAL_FOLLOW_FRIENDS" · "FOLLOWER_OF_CREATOR" · "SELF_ONLY"sí
choices.allowCommentbooleanosí
choices.allowDuetbooleanosí
choices.allowStitchbooleanosí
choices.durationSecondsnúmerosí
brandContentbooleanosí
brandOrganicbooleanosí
isAigcbooleanosí
musicConsentbooleanosí
expressConsentbooleanosí
JSON Schema de entrada
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "mediaId": {
      "type": "string",
      "minLength": 1,
      "maxLength": 240
    },
    "mediaSha256": {
      "type": "string",
      "pattern": "^[a-f0-9]{64}$"
    },
    "creatorInfoSha256": {
      "type": "string",
      "pattern": "^[a-f0-9]{64}$"
    },
    "idempotencyKey": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "title": {
      "type": "string",
      "maxLength": 2200
    },
    "choices": {
      "type": "object",
      "properties": {
        "privacy": {
          "type": "string",
          "enum": [
            "PUBLIC_TO_EVERYONE",
            "MUTUAL_FOLLOW_FRIENDS",
            "FOLLOWER_OF_CREATOR",
            "SELF_ONLY"
          ]
        },
        "allowComment": {
          "type": "boolean"
        },
        "allowDuet": {
          "type": "boolean"
        },
        "allowStitch": {
          "type": "boolean"
        },
        "durationSeconds": {
          "type": "number",
          "exclusiveMinimum": 0
        }
      },
      "required": [
        "privacy",
        "allowComment",
        "allowDuet",
        "allowStitch",
        "durationSeconds"
      ],
      "additionalProperties": false
    },
    "brandContent": {
      "type": "boolean"
    },
    "brandOrganic": {
      "type": "boolean"
    },
    "isAigc": {
      "type": "boolean"
    },
    "musicConsent": {
      "type": "boolean",
      "const": true
    },
    "expressConsent": {
      "type": "boolean",
      "const": true
    }
  },
  "required": [
    "mediaId",
    "mediaSha256",
    "creatorInfoSha256",
    "idempotencyKey",
    "title",
    "choices",
    "brandContent",
    "brandOrganic",
    "isAigc",
    "musicConsent",
    "expressConsent"
  ],
  "additionalProperties": false
}

Ejemplo

curl
curl -X POST https://connect.emisso.ai/api/v1/tools/tiktok.publicacion.aprobar/execute \
  -H "Authorization: Bearer connect_sk_…" \
  -H "X-Connect-Connection: conn_9tKfR2mQx4Vb" \
  -H "Content-Type: application/json" \
  -d '{"input":{"mediaId":"media_ejemplo","mediaSha256":"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa","creatorInfoSha256":"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa","idempotencyKey":"00000000-0000-4000-8000-000000000001","title":"Video aprobado","choices":{"privacy":"SELF_ONLY","allowComment":false,"allowDuet":false,"allowStitch":false,"durationSeconds":5},"brandContent":false,"brandOrganic":false,"isAigc":false,"musicConsent":true,"expressConsent":true}}'
MCP · meta-tool execute_write
{
  "tool": "tiktok.publicacion.aprobar",
  "params": {
    "mediaId": "media_ejemplo",
    "mediaSha256": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
    "creatorInfoSha256": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
    "idempotencyKey": "00000000-0000-4000-8000-000000000001",
    "title": "Video aprobado",
    "choices": {
      "privacy": "SELF_ONLY",
      "allowComment": false,
      "allowDuet": false,
      "allowStitch": false,
      "durationSeconds": 5
    },
    "brandContent": false,
    "brandOrganic": false,
    "isAigc": false,
    "musicConsent": true,
    "expressConsent": true
  },
  "connectionId": "conn_9tKfR2mQx4Vb"
}

Salida esperada (200):

{
  "data": {
    "approvalId": "aprobacion_ejemplo",
    "intentSha256": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
    "idempotencyKey": "00000000-0000-4000-8000-000000000001",
    "expiresAt": 1800000000000
  },
  "meta": {
    "request_id": "req_…",
    "tool_id": "tiktok.publicacion.aprobar",
    "plane": "action",
    "latency_ms": 24,
    "audit_status": "recorded"
  }
}

Salida

CampoTipoRequeridoDescripción
approvalIdstringsí
intentSha256string ^[a-f0-9]{64}$sí
idempotencyKeystring `^([0-9a-fA-F]8-[0-9a-fA-F]4-[1-8][0-9a-fA-F]3-[89abAB][0-9a-fA-F]3-[0-9a-fA-F]1200000000-0000-0000-0000-000000000000ffffffff-ffff-ffff-ffff-ffffffffffff)$`
expiresAtnúmerosí
JSON Schema de salida
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "approvalId": {
      "type": "string",
      "minLength": 1,
      "maxLength": 240
    },
    "intentSha256": {
      "type": "string",
      "pattern": "^[a-f0-9]{64}$"
    },
    "idempotencyKey": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "expiresAt": {
      "type": "number"
    }
  },
  "required": [
    "approvalId",
    "intentSha256",
    "idempotencyKey",
    "expiresAt"
  ],
  "additionalProperties": false
}

Errores de esta tool

CódigoHTTPReintentableQué hacer
connection_disabled403noReactívala en /connections o usa otra conexión del mismo sistema.
connection_not_found404noUsa uno de los connectionId que lista el error, o revisa la conexión en /connections. No hace falta reactivar nada.

Toda llamada puede devolver además los códigos transversales (validation_error, unauthorized, scope_not_granted, rate_limited, entre otros): el detalle vive en el catálogo de errores.

En esta página