Actualizar archivo

Actualiza los metadatos de la información de un archivo existente.

API de WhatsApp y CRM

Necesitas una clave de API. Pídela a nuestro equipo de soporte o créala desde la plataforma.

PATCH https://api.getincloud.ai/v1/files/{fileId}

Actualiza los metadatos de la información de un archivo existente.

Puedes actualizar los siguientes campos del archivo:

filename

reference

expiration

permission

tags (lista de cadenas de texto)

format (solo para archivos de tipo video y audio)

Prueba este endpoint en el probador de API en vivo

>¿Necesitas ayuda? Explora todos los tutoriales, más de 100 ejemplos de casos de uso y juega con el probador de API en vivo con ejemplos de código listos para usar en más de 15 lenguajes de programación, incluidos JavaScript/Node.js, PHP, Python, C#, Java, Ruby, Swift, Kotlin, Powershell, cURL y más.

Autenticación

Envía tu API key en el encabezado Token en cada petición.

Cuerpo de la petición

Campo	Tipo	Obligatorio	Descripción
`filename`	string	No	`minLength: 1` · `maxLength: 200`
`reference`	string	No	`minLength: 2` · `maxLength: 150`
`format`	string	No	`enum: ['gif', 'ptt', 'native']` · `default: native`
`tags`	array<string>	No
`message`	string	No	Texto opcional del pie de foto del archivo multimedia que se usará al entregar el mensaje. Solo aplica a archivos multimedia de tipo imagen y video; en otros casos se ignora. Se usa cuando no hay un campo de cuerpo de mensaje definido en el mensaje que se va a entregar. `minLength: 0` · `maxLength: 15000`
`expiration`	string	No	`enum: ['10m', '30m', '1h', '6h', '12h', '1d', '2d', '3d', '5d', '6d', '7d', '15d', '30d', '60d', '90d', '120d', '180d', '360d', '1y', '2y']` · `minLength: 2` · `maxLength: 5`
`permission`	string	No	Permiso de acceso opcional al archivo. Por defecto es `public`: todos los miembros del equipo pueden acceder, descargar y enviar el archivo. Si se establece en `private`, solo el propietario del archivo puede acceder, descargar y enviar el archivo. `enum: ['public', 'readonly', 'private']` · `default: public`

Respuestas

Código	Descripción
`202`	Documento de actualización del archivo
`400`	Datos de la consulta o del cuerpo de la solicitud no válidos
`401`	No autorizado: token de API no válido o ausente
`403`	Faltan los permisos requeridos
`404`	Recurso no encontrado
`409`	Conflicto
`429`	Demasiadas solicitudes: inténtalo de nuevo más tarde
`500`	Error inesperado
`501`	No implementado
`503`	Servicio no disponible temporalmente: inténtalo de nuevo más tarde

// This code example requires you to have installed curl package
// Installation instructions here: https://curl.haxx.se/download.html

// Update file metadata
curl --request PATCH \
  --url https://api.getincloud.ai/v1/files/{id} \
  --header 'Content-Type: application/json' \
  --header 'Token: <api token goes here>' \
  --data '{"filename":"newname.jpg","tags":["foo","bar"],"reference":"123456789"}'

AnteriorSubir multimedia del encabezado de plantilla SiguienteBuscar archivos

¿Te sirvió esta página?