Box

Box é uma plataforma líder de gerenciamento de conteúdo na nuvem e compartilhamento de arquivos, usada por empresas em todo o mundo para armazenar, gerenciar e colaborar em arquivos com segurança. O Box oferece APIs robustas para automatizar operações de arquivos e integrar-se a fluxos de trabalho de negócios, incluindo o Box Sign para assinaturas eletrônicas nativas.

Com a integração do Box no Zoen, você pode:

  • Enviar arquivos: Envie documentos, imagens e outros arquivos para qualquer pasta do Box
  • Baixar arquivos: Recupere o conteúdo de arquivos do Box para processamento nos seus fluxos de trabalho
  • Obter informações do arquivo: Acesse metadados detalhados, incluindo tamanho, proprietário, timestamps, tags e links compartilhados
  • Listar conteúdo de pastas: Navegue por arquivos e pastas com suporte a ordenação e paginação
  • Criar pastas: Organize seu armazenamento no Box criando novas pastas de forma programática
  • Excluir arquivos e pastas: Remova conteúdo com exclusão recursiva opcional para pastas
  • Copiar arquivos: Duplique arquivos entre pastas com opção de renomeação
  • Pesquisar: Encontre arquivos e pastas por nome, conteúdo, extensão ou localização
  • Atualizar metadados do arquivo: Renomeie, mova, adicione descrições ou marque arquivos com tags
  • Criar solicitações de assinatura: Envie documentos para assinatura eletrônica com um ou mais signatários
  • Acompanhar status da assinatura: Monitore o progresso das solicitações de assinatura
  • Listar solicitações de assinatura: Veja todas as solicitações de assinatura com paginação baseada em marcadores
  • Cancelar solicitações de assinatura: Cancele solicitações pendentes que não são mais necessárias
  • Reenviar lembretes de assinatura: Envie notificações de lembrete a signatários que ainda não concluíram a assinatura

Essas capacidades permitem que seus agentes Zoen automatizem operações do Box diretamente nos seus fluxos de trabalho — desde organizar documentos e distribuir conteúdo até processar arquivos enviados, gerenciar fluxos de assinatura eletrônica para cartas de oferta e contratos, e manter um armazenamento em nuvem estruturado como parte dos seus processos de negócio.

Usage Instructions

Integrate Box into your workflow to manage files, folders, and e-signatures. Upload and download files, search content, create folders, send documents for e-signature, track signing status, and more.

Actions

box_upload_file

Upload a file to a Box folder

Input

ParameterTypeRequiredDescription
parentFolderIdstringYesThe ID of the folder to upload the file to (use "0" for root)
filefileNoThe file to upload (UserFile object)
fileContentstringNoLegacy: base64 encoded file content
fileNamestringNoOptional filename override

Output

ParameterTypeDescription
idstringFile ID
namestringFile name
sizenumberFile size in bytes
sha1stringSHA1 hash of file content
createdAtstringCreation timestamp
modifiedAtstringLast modified timestamp
parentIdstringParent folder ID
parentNamestringParent folder name

box_download_file

Download a file from Box

Input

ParameterTypeRequiredDescription
fileIdstringYesThe ID of the file to download

Output

ParameterTypeDescription
filefileDownloaded file stored in execution files
contentstringBase64 encoded file content

box_get_file_info

Get detailed information about a file in Box

Input

ParameterTypeRequiredDescription
fileIdstringYesThe ID of the file to get information about

Output

ParameterTypeDescription
idstringFile ID
namestringFile name
descriptionstringFile description
sizenumberFile size in bytes
sha1stringSHA1 hash of file content
createdAtstringCreation timestamp
modifiedAtstringLast modified timestamp
createdByobjectUser who created the file
modifiedByobjectUser who last modified the file
ownedByobjectUser who owns the file
parentIdstringParent folder ID
parentNamestringParent folder name
sharedLinkjsonShared link details
tagsarrayFile tags
commentCountnumberNumber of comments

box_list_folder_items

List files and folders in a Box folder

Input

ParameterTypeRequiredDescription
folderIdstringYesThe ID of the folder to list items from (use "0" for root)
limitnumberNoMaximum number of items to return per page
offsetnumberNoThe offset for pagination
sortstringNoSort field: id, name, date, or size
directionstringNoSort direction: ASC or DESC

Output

ParameterTypeDescription
entriesarrayList of items in the folder
typestringItem type (file, folder, web_link)
idstringItem ID
namestringItem name
sizenumberItem size in bytes
createdAtstringCreation timestamp
modifiedAtstringLast modified timestamp
totalCountnumberTotal number of items in the folder
offsetnumberCurrent pagination offset
limitnumberCurrent pagination limit

box_create_folder

Create a new folder in Box

Input

ParameterTypeRequiredDescription
namestringYesName for the new folder
parentFolderIdstringYesThe ID of the parent folder (use "0" for root)

Output

ParameterTypeDescription
idstringFolder ID
namestringFolder name
createdAtstringCreation timestamp
modifiedAtstringLast modified timestamp
parentIdstringParent folder ID
parentNamestringParent folder name

box_delete_file

Delete a file from Box

Input

ParameterTypeRequiredDescription
fileIdstringYesThe ID of the file to delete

Output

ParameterTypeDescription
deletedbooleanWhether the file was successfully deleted
messagestringSuccess confirmation message

box_delete_folder

Delete a folder from Box

Input

ParameterTypeRequiredDescription
folderIdstringYesThe ID of the folder to delete
recursivebooleanNoDelete folder and all its contents recursively

Output

ParameterTypeDescription
deletedbooleanWhether the folder was successfully deleted
messagestringSuccess confirmation message

box_copy_file

Copy a file to another folder in Box

Input

ParameterTypeRequiredDescription
fileIdstringYesThe ID of the file to copy
parentFolderIdstringYesThe ID of the destination folder
namestringNoOptional new name for the copied file

Output

ParameterTypeDescription
idstringFile ID
namestringFile name
sizenumberFile size in bytes
sha1stringSHA1 hash of file content
createdAtstringCreation timestamp
modifiedAtstringLast modified timestamp
parentIdstringParent folder ID
parentNamestringParent folder name

Search for files and folders in Box

Input

ParameterTypeRequiredDescription
querystringYesThe search query string
limitnumberNoMaximum number of results to return
offsetnumberNoThe offset for pagination
ancestorFolderIdstringNoRestrict search to a specific folder and its subfolders
fileExtensionsstringNoComma-separated file extensions to filter by (e.g., pdf,docx)
typestringNoRestrict to a specific content type: file, folder, or web_link

Output

ParameterTypeDescription
resultsarraySearch results
typestringItem type (file, folder, web_link)
idstringItem ID
namestringItem name
sizenumberItem size in bytes
createdAtstringCreation timestamp
modifiedAtstringLast modified timestamp
parentIdstringParent folder ID
parentNamestringParent folder name
totalCountnumberTotal number of matching results

box_update_file

Update file info in Box (rename, move, change description, add tags)

Input

ParameterTypeRequiredDescription
fileIdstringYesThe ID of the file to update
namestringNoNew name for the file
descriptionstringNoNew description for the file (max 256 characters)
parentFolderIdstringNoMove the file to a different folder by specifying the folder ID
tagsstringNoComma-separated tags to set on the file

Output

ParameterTypeDescription
idstringFile ID
namestringFile name
descriptionstringFile description
sizenumberFile size in bytes
sha1stringSHA1 hash of file content
createdAtstringCreation timestamp
modifiedAtstringLast modified timestamp
createdByobjectUser who created the file
modifiedByobjectUser who last modified the file
ownedByobjectUser who owns the file
parentIdstringParent folder ID
parentNamestringParent folder name
sharedLinkjsonShared link details
tagsarrayFile tags
commentCountnumberNumber of comments

box_sign_create_request

Create a new Box Sign request to send documents for e-signature

Input

ParameterTypeRequiredDescription
sourceFileIdsstringYesComma-separated Box file IDs to send for signing
signerEmailstringYesPrimary signer email address
signerRolestringNoPrimary signer role: signer, approver, or final_copy_reader (default: signer)
additionalSignersstringNoJSON array of additional signers, e.g. [{"email":"user@example.com","role":"signer"}]
parentFolderIdstringNoBox folder ID where signed documents will be stored (default: user root)
emailSubjectstringNoCustom subject line for the signing email
emailMessagestringNoCustom message in the signing email body
namestringNoName for the sign request
daysValidnumberNoNumber of days before the request expires (0-730)
areRemindersEnabledbooleanNoWhether to send automatic signing reminders
areTextSignaturesEnabledbooleanNoWhether to allow typed (text) signatures
signatureColorstringNoSignature color: blue, black, or red
redirectUrlstringNoURL to redirect signers to after signing
declinedRedirectUrlstringNoURL to redirect signers to after declining
isDocumentPreparationNeededbooleanNoWhether document preparation is needed before sending
externalIdstringNoExternal system reference ID

Output

ParameterTypeDescription
idstringSign request ID
statusstringRequest status (converting, created, sent, viewed, signed, cancelled, declined, expired, error_converting, error_sending, finalizing, error_finalizing)
namestringSign request name
shortIdstringHuman-readable short ID
signersarrayList of signers
sourceFilesarraySource files for signing
emailSubjectstringCustom email subject line
emailMessagestringCustom email message body
daysValidnumberNumber of days the request is valid
createdAtstringCreation timestamp
autoExpireAtstringAuto-expiration timestamp
prepareUrlstringURL for document preparation (if preparation is needed)
senderEmailstringEmail of the sender

box_sign_get_request

Get the details and status of a Box Sign request

Input

ParameterTypeRequiredDescription
signRequestIdstringYesThe ID of the sign request to retrieve

Output

ParameterTypeDescription
idstringSign request ID
statusstringRequest status (converting, created, sent, viewed, signed, cancelled, declined, expired, error_converting, error_sending, finalizing, error_finalizing)
namestringSign request name
shortIdstringHuman-readable short ID
signersarrayList of signers
sourceFilesarraySource files for signing
emailSubjectstringCustom email subject line
emailMessagestringCustom email message body
daysValidnumberNumber of days the request is valid
createdAtstringCreation timestamp
autoExpireAtstringAuto-expiration timestamp
prepareUrlstringURL for document preparation (if preparation is needed)
senderEmailstringEmail of the sender

box_sign_list_requests

List all Box Sign requests

Input

ParameterTypeRequiredDescription
limitnumberNoMaximum number of sign requests to return (max 1000)
markerstringNoPagination marker from a previous response

Output

ParameterTypeDescription
signRequestsarrayList of sign requests
idstringSign request ID
statusstringRequest status (converting, created, sent, viewed, signed, cancelled, declined, expired, error_converting, error_sending, finalizing, error_finalizing)
namestringSign request name
shortIdstringHuman-readable short ID
signersarrayList of signers
sourceFilesarraySource files for signing
emailSubjectstringCustom email subject line
emailMessagestringCustom email message body
daysValidnumberNumber of days the request is valid
createdAtstringCreation timestamp
autoExpireAtstringAuto-expiration timestamp
prepareUrlstringURL for document preparation (if preparation is needed)
senderEmailstringEmail of the sender
countnumberNumber of sign requests returned in this page
nextMarkerstringMarker for next page of results

box_sign_cancel_request

Cancel a pending Box Sign request

Input

ParameterTypeRequiredDescription
signRequestIdstringYesThe ID of the sign request to cancel

Output

ParameterTypeDescription
idstringSign request ID
statusstringRequest status (converting, created, sent, viewed, signed, cancelled, declined, expired, error_converting, error_sending, finalizing, error_finalizing)
namestringSign request name
shortIdstringHuman-readable short ID
signersarrayList of signers
sourceFilesarraySource files for signing
emailSubjectstringCustom email subject line
emailMessagestringCustom email message body
daysValidnumberNumber of days the request is valid
createdAtstringCreation timestamp
autoExpireAtstringAuto-expiration timestamp
prepareUrlstringURL for document preparation (if preparation is needed)
senderEmailstringEmail of the sender

box_sign_resend_request

Resend a Box Sign request to signers who have not yet signed

Input

ParameterTypeRequiredDescription
signRequestIdstringYesThe ID of the sign request to resend

Output

ParameterTypeDescription
messagestringSuccess confirmation message

On this page