Skip to content

Commit ea6570c

Browse files
waleedlatif1claude
waleedlatif1
and
claude
committed
refactor(box): merge Box Sign into single Box block
Combine Box and Box Sign into one unified block with all 15 operations accessible via a single dropdown, removing the separate box_sign block. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
1 parent b6b1c45 commit ea6570c

File tree

7 files changed

+392
-495
lines changed

7 files changed

+392
-495
lines changed

‎apps/docs/components/ui/icon-mapping.ts‎

Lines changed: 6 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -48,8 +48,8 @@ import {
4848
FirecrawlIcon,
4949
FirefliesIcon,
5050
GammaIcon,
51-
GithubIcon,
5251
GitLabIcon,
52+
GithubIcon,
5353
GmailIcon,
5454
GongIcon,
5555
GoogleAdsIcon,
@@ -92,9 +92,9 @@ import {
9292
LinkupIcon,
9393
LoopsIcon,
9494
LumaIcon,
95+
MailServerIcon,
9596
MailchimpIcon,
9697
MailgunIcon,
97-
MailServerIcon,
9898
Mem0Icon,
9999
MicrosoftDataverseIcon,
100100
MicrosoftExcelIcon,
@@ -129,6 +129,8 @@ import {
129129
ResendIcon,
130130
RevenueCatIcon,
131131
S3Icon,
132+
SQSIcon,
133+
STTIcon,
132134
SalesforceIcon,
133135
SearchIcon,
134136
SendgridIcon,
@@ -140,19 +142,17 @@ import {
140142
SimilarwebIcon,
141143
SlackIcon,
142144
SmtpIcon,
143-
SQSIcon,
144145
SshIcon,
145-
STTIcon,
146146
StagehandIcon,
147147
StripeIcon,
148148
SupabaseIcon,
149+
TTSIcon,
149150
TavilyIcon,
150151
TelegramIcon,
151152
TextractIcon,
152153
TinybirdIcon,
153154
TranslateIcon,
154155
TrelloIcon,
155-
TTSIcon,
156156
TwilioIcon,
157157
TypeformIcon,
158158
UpstashIcon,
@@ -163,11 +163,11 @@ import {
163163
WhatsAppIcon,
164164
WikipediaIcon,
165165
WordpressIcon,
166-
xIcon,
167166
YouTubeIcon,
168167
ZendeskIcon,
169168
ZepIcon,
170169
ZoomIcon,
170+
xIcon,
171171
} from '@/components/icons'
172172

173173
type IconComponent = ComponentType<SVGProps<SVGSVGElement>>
@@ -186,7 +186,6 @@ export const blockTypeToIconMap: Record<string, IconComponent> = {
186186
ashby: AshbyIcon,
187187
attio: AttioIcon,
188188
box: BoxCompanyIcon,
189-
box_sign: BoxCompanyIcon,
190189
brandfetch: BrandfetchIcon,
191190
browser_use: BrowserUseIcon,
192191
calcom: CalComIcon,

‎apps/docs/content/docs/en/tools/box.mdx‎

Lines changed: 156 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: Box
3-
description: Upload, download, search, and manage files and folders in Box
3+
description: Manage files, folders, and e-signatures with Box
44
---
55

66
import { BlockInfoCard } from "@/components/ui/block-info-card"
@@ -11,7 +11,7 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
1111
/>
1212

1313
{/* MANUAL-CONTENT-START:intro */}
14-
[Box](https://www.box.com/) is a leading cloud content management and file sharing platform trusted by enterprises worldwide to securely store, manage, and collaborate on files. Box provides robust APIs for automating file operations and integrating with business workflows.
14+
[Box](https://www.box.com/) is a leading cloud content management and file sharing platform trusted by enterprises worldwide to securely store, manage, and collaborate on files. Box provides robust APIs for automating file operations and integrating with business workflows, including [Box Sign](https://www.box.com/esignature) for native e-signatures.
1515

1616
With the Box integration in Sim, you can:
1717

@@ -24,14 +24,19 @@ With the Box integration in Sim, you can:
2424
- **Copy files**: Duplicate files across folders with optional renaming
2525
- **Search**: Find files and folders by name, content, extension, or location
2626
- **Update file metadata**: Rename, move, add descriptions, or tag files
27+
- **Create sign requests**: Send documents for e-signature with one or more signers
28+
- **Track signing status**: Monitor the progress of sign requests
29+
- **List sign requests**: View all sign requests with marker-based pagination
30+
- **Cancel sign requests**: Cancel pending sign requests that are no longer needed
31+
- **Resend sign reminders**: Send reminder notifications to signers who haven't completed signing
2732

28-
These capabilities allow your Sim agents to automate Box operations directly within your workflows — from organizing documents and distributing content to processing uploaded files and maintaining structured cloud storage as part of your business processes.
33+
These capabilities allow your Sim agents to automate Box operations directly within your workflows — from organizing documents and distributing content to processing uploaded files, managing e-signature workflows for offer letters and contracts, and maintaining structured cloud storage as part of your business processes.
2934
{/* MANUAL-CONTENT-END */}
3035

3136

3237
## Usage Instructions
3338

34-
Integrate Box into your workflow to manage files and folders. Upload and download files, get file information, list folder contents, create and delete folders, copy files, search across your Box account, and update file metadata.
39+
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.
3540

3641

3742

@@ -285,4 +290,151 @@ Update file info in Box (rename, move, change description, add tags)
285290
| `tags` | array | File tags |
286291
| `commentCount` | number | Number of comments |
287292

293+
### `box_sign_create_request`
294+
295+
Create a new Box Sign request to send documents for e-signature
296+
297+
#### Input
298+
299+
| Parameter | Type | Required | Description |
300+
| --------- | ---- | -------- | ----------- |
301+
| `sourceFileIds` | string | Yes | Comma-separated Box file IDs to send for signing |
302+
| `signerEmail` | string | Yes | Primary signer email address |
303+
| `signerRole` | string | No | Primary signer role: signer, approver, or final_copy_reader \(default: signer\) |
304+
| `additionalSigners` | string | No | JSON array of additional signers, e.g. \[\{"email":"user@example.com","role":"signer"\}\] |
305+
| `parentFolderId` | string | No | Box folder ID where signed documents will be stored \(default: user root\) |
306+
| `emailSubject` | string | No | Custom subject line for the signing email |
307+
| `emailMessage` | string | No | Custom message in the signing email body |
308+
| `name` | string | No | Name for the sign request |
309+
| `daysValid` | number | No | Number of days before the request expires \(0-730\) |
310+
| `areRemindersEnabled` | boolean | No | Whether to send automatic signing reminders |
311+
| `areTextSignaturesEnabled` | boolean | No | Whether to allow typed \(text\) signatures |
312+
| `signatureColor` | string | No | Signature color: blue, black, or red |
313+
| `redirectUrl` | string | No | URL to redirect signers to after signing |
314+
| `declinedRedirectUrl` | string | No | URL to redirect signers to after declining |
315+
| `isDocumentPreparationNeeded` | boolean | No | Whether document preparation is needed before sending |
316+
| `externalId` | string | No | External system reference ID |
317+
318+
#### Output
319+
320+
| Parameter | Type | Description |
321+
| --------- | ---- | ----------- |
322+
| `id` | string | Sign request ID |
323+
| `status` | string | Request status \(converting, created, sent, viewed, signed, cancelled, declined, expired, error_converting, error_sending, finalizing, error_finalizing\) |
324+
| `name` | string | Sign request name |
325+
| `shortId` | string | Human-readable short ID |
326+
| `signers` | array | List of signers |
327+
| `sourceFiles` | array | Source files for signing |
328+
| `emailSubject` | string | Custom email subject line |
329+
| `emailMessage` | string | Custom email message body |
330+
| `daysValid` | number | Number of days the request is valid |
331+
| `createdAt` | string | Creation timestamp |
332+
| `autoExpireAt` | string | Auto-expiration timestamp |
333+
| `prepareUrl` | string | URL for document preparation \(if preparation is needed\) |
334+
| `senderEmail` | string | Email of the sender |
335+
336+
### `box_sign_get_request`
337+
338+
Get the details and status of a Box Sign request
339+
340+
#### Input
341+
342+
| Parameter | Type | Required | Description |
343+
| --------- | ---- | -------- | ----------- |
344+
| `signRequestId` | string | Yes | The ID of the sign request to retrieve |
345+
346+
#### Output
347+
348+
| Parameter | Type | Description |
349+
| --------- | ---- | ----------- |
350+
| `id` | string | Sign request ID |
351+
| `status` | string | Request status \(converting, created, sent, viewed, signed, cancelled, declined, expired, error_converting, error_sending, finalizing, error_finalizing\) |
352+
| `name` | string | Sign request name |
353+
| `shortId` | string | Human-readable short ID |
354+
| `signers` | array | List of signers |
355+
| `sourceFiles` | array | Source files for signing |
356+
| `emailSubject` | string | Custom email subject line |
357+
| `emailMessage` | string | Custom email message body |
358+
| `daysValid` | number | Number of days the request is valid |
359+
| `createdAt` | string | Creation timestamp |
360+
| `autoExpireAt` | string | Auto-expiration timestamp |
361+
| `prepareUrl` | string | URL for document preparation \(if preparation is needed\) |
362+
| `senderEmail` | string | Email of the sender |
363+
364+
### `box_sign_list_requests`
365+
366+
List all Box Sign requests
367+
368+
#### Input
369+
370+
| Parameter | Type | Required | Description |
371+
| --------- | ---- | -------- | ----------- |
372+
| `limit` | number | No | Maximum number of sign requests to return \(max 1000\) |
373+
| `marker` | string | No | Pagination marker from a previous response |
374+
375+
#### Output
376+
377+
| Parameter | Type | Description |
378+
| --------- | ---- | ----------- |
379+
| `signRequests` | array | List of sign requests |
380+
| ↳ `id` | string | Sign request ID |
381+
| ↳ `status` | string | Request status \(converting, created, sent, viewed, signed, cancelled, declined, expired, error_converting, error_sending, finalizing, error_finalizing\) |
382+
| ↳ `name` | string | Sign request name |
383+
| ↳ `shortId` | string | Human-readable short ID |
384+
| ↳ `signers` | array | List of signers |
385+
| ↳ `sourceFiles` | array | Source files for signing |
386+
| ↳ `emailSubject` | string | Custom email subject line |
387+
| ↳ `emailMessage` | string | Custom email message body |
388+
| ↳ `daysValid` | number | Number of days the request is valid |
389+
| ↳ `createdAt` | string | Creation timestamp |
390+
| ↳ `autoExpireAt` | string | Auto-expiration timestamp |
391+
| ↳ `prepareUrl` | string | URL for document preparation \(if preparation is needed\) |
392+
| ↳ `senderEmail` | string | Email of the sender |
393+
| `count` | number | Number of sign requests returned in this page |
394+
| `nextMarker` | string | Marker for next page of results |
395+
396+
### `box_sign_cancel_request`
397+
398+
Cancel a pending Box Sign request
399+
400+
#### Input
401+
402+
| Parameter | Type | Required | Description |
403+
| --------- | ---- | -------- | ----------- |
404+
| `signRequestId` | string | Yes | The ID of the sign request to cancel |
405+
406+
#### Output
407+
408+
| Parameter | Type | Description |
409+
| --------- | ---- | ----------- |
410+
| `id` | string | Sign request ID |
411+
| `status` | string | Request status \(converting, created, sent, viewed, signed, cancelled, declined, expired, error_converting, error_sending, finalizing, error_finalizing\) |
412+
| `name` | string | Sign request name |
413+
| `shortId` | string | Human-readable short ID |
414+
| `signers` | array | List of signers |
415+
| `sourceFiles` | array | Source files for signing |
416+
| `emailSubject` | string | Custom email subject line |
417+
| `emailMessage` | string | Custom email message body |
418+
| `daysValid` | number | Number of days the request is valid |
419+
| `createdAt` | string | Creation timestamp |
420+
| `autoExpireAt` | string | Auto-expiration timestamp |
421+
| `prepareUrl` | string | URL for document preparation \(if preparation is needed\) |
422+
| `senderEmail` | string | Email of the sender |
423+
424+
### `box_sign_resend_request`
425+
426+
Resend a Box Sign request to signers who have not yet signed
427+
428+
#### Input
429+
430+
| Parameter | Type | Required | Description |
431+
| --------- | ---- | -------- | ----------- |
432+
| `signRequestId` | string | Yes | The ID of the sign request to resend |
433+
434+
#### Output
435+
436+
| Parameter | Type | Description |
437+
| --------- | ---- | ----------- |
438+
| `message` | string | Success confirmation message |
439+
288440

0 commit comments

Comments
 (0)