AGENT SKILL
pm-box
Box connector knowledge and safe action guide.
- License 许可
- AGPL-3.0
- 最近更新
- 2026-09-21
- Stars
- ★ 7
- Forks
- 0
01 前言 Front Matter
- name
- pm-box
- description
- Box connector knowledge and safe action guide.
02 资源文件 1
- 参考文档MANUAL.md7.0 KB
03 SKILL.md 正文
pm-box
Purpose
Reads Box users, groups, collections, folder items, webhooks, retention policies, legal hold policies, storage policies, sign requests, terms of services, metadata templates, and pending collaborations, and writes group/webhook/collaboration lifecycle mutations, through the Box REST API using the OAuth2 client-credentials grant.
Icon
- id: simple-icons-box
- asset: icons/simple-icons/box.svg
- title: Box
- simple_icon_slug: box
- simple_icon_hex: 0061D5
- source: simple-icons
- license: CC0-1.0
- review_status: cc0_with_trademark_caveat
- review_url: https://simpleicons.org/?q=Box
- match: exact-name-or-slug
- matched_by: box
Capabilities
- check=true catalog=true read=true write=true query=false
- Integration type: api
Authentication
- Use pm credentials add with --from-env or --value-stdin for secret fields.
Configuration
- base_url
- box_subject_id
- box_subject_type
- folder_id
- mode
- token_url
- client_id (secret) (required)
- client_secret (secret) (required)
ETL Streams
- users:
- primary key: id
- cursor: modified_at
- fields: created_at(string), id(string), language(string), login(string), modified_at(string), name(string), status(string), timezone(string), type(string)
- groups:
- primary key: id
- cursor: modified_at
- fields: created_at(string), group_type(string), id(string), modified_at(string), name(string), type(string)
- collections:
- primary key: id
- fields: collection_type(string), id(string), name(string), type(string)
- folder_items:
- primary key: id
- cursor: modified_at
- fields: created_at(string), etag(string), id(string), modified_at(string), name(string), sequence_id(string), sha1(string), size(integer), type(string)
- webhooks:
- primary key: id
- fields: address(string), created_at(string), created_by(object), id(string), target(object), triggers(array), type(string)
- retention_policies:
- primary key: id
- cursor: modified_at
- fields: are_owners_notified(boolean), can_owner_extend_retention(boolean), created_at(string), created_by(object), custom_notification_recipients(array), description(string), disposition_action(string), id(string), modified_at(string), policy_name(string), policy_type(string), retention_length(string), retention_type(string), status(string), type(string)
- legal_hold_policies:
- primary key: id
- cursor: modified_at
- fields: assignment_counts(object), created_at(string), created_by(object), description(string), filter_ended_at(string), filter_started_at(string), id(string), modified_at(string), policy_name(string), status(string), type(string)
- storage_policies:
- primary key: id
- fields: id(string), name(string), type(string)
- sign_requests:
- primary key: id
- cursor: created_at
- fields: auto_expire_at(string), created_at(string), finished_at(string), id(string), parent_folder(object), prepare_url(string), sender_email(string), sign_files(object), signers(array), signing_log(object), source_files(array), status(string), type(string)
- terms_of_services:
- primary key: id
- cursor: modified_at
- fields: created_at(string), id(string), modified_at(string), status(string), text(string), tos_type(string), type(string)
- metadata_templates:
- primary key: id
- fields: copy_instance_on_item_copy(boolean), display_name(string), fields(array), hidden(boolean), id(string), scope(string), template_key(string), type(string)
- pending_collaborations:
- primary key: id
- cursor: modified_at
- fields: accessible_by(object), acknowledged_at(string), created_at(string), created_by(object), expires_at(string), id(string), invite_email(string), is_access_only(boolean), item(object), modified_at(string), role(string), status(string), type(string)
Sync Modes
- ETL sync modes: full_refresh_append, full_refresh_overwrite, full_refresh_overwrite_deduped
Reverse ETL Actions
- create_group:
- endpoint: POST /groups
- required fields: name
- risk: external mutation; creates a new Box enterprise group; approval required
- update_group:
- endpoint: PUT /groups/{{ record.id }}
- required fields: id
- risk: external mutation; updates an existing Box enterprise group's settings; approval required
- delete_group:
- endpoint: DELETE /groups/{{ record.id }}
- required fields: id
- risk: destructive external mutation; permanently deletes a Box enterprise group; approval required
- create_webhook:
- endpoint: POST /webhooks
- required fields: target, address, triggers
- risk: external mutation; creates a new Box webhook subscription that will POST event payloads to an external address; approval required
- update_webhook:
- endpoint: PUT /webhooks/{{ record.id }}
- required fields: id
- risk: external mutation; updates an existing Box webhook's target/address/triggers; approval required
- delete_webhook:
- endpoint: DELETE /webhooks/{{ record.id }}
- required fields: id
- risk: destructive external mutation; permanently deletes a Box webhook subscription; approval required
- create_collaboration:
- endpoint: POST /collaborations
- required fields: item, accessible_by, role
- risk: external mutation; grants a user or group access to a Box file/folder; approval required
- update_collaboration:
- endpoint: PUT /collaborations/{{ record.id }}
- required fields: id
- risk: external mutation; changes an existing Box collaboration's role, or accepts/rejects a pending invitation; approval required
- delete_collaboration:
- endpoint: DELETE /collaborations/{{ record.id }}
- required fields: id
- risk: destructive external mutation; permanently revokes a user or group's access to a Box file/folder; approval required
Security
- read risk: external Box API read of enterprise users, groups, collections, folder items, webhooks, retention policies, legal hold policies, storage policies, sign requests, terms of services, metadata templates, and pending collaborations
- write risk: external mutation of Box enterprise groups, webhook subscriptions, and file/folder collaborations (access grants); includes 3 destructive (irreversible-effect) actions (delete_group, delete_webhook, delete_collaboration)
- approval: required for every write action; read remains unapproved
- Never pass secret values in chat, shell arguments, logs, docs, or JSON output.
Commands
Inspect as a manual
pm connectors inspect box
Inspect as structured JSON
pm connectors inspect box --json
Agent Rules
- Run pm connectors inspect box before creating credentials or plans.
- Use --json only when the caller needs structured output; use the manual for human-readable guidance.
- Never ask the user to paste secret values into chat.
- For reverse ETL writes, create a plan, show the preview, wait for explicit approval, then run with the approval token.
04 同仓库更多 Skills
recipe-preview-approve-reverse-etl
Preview and approve a reverse ETL plan safely.
★ 7
recipe-github-prs-to-warehouse
Sync GitHub pull requests into the local warehouse.
★ 7
pm-zoom
Zoom connector knowledge and safe action guide.
★ 7
pm-zonka-feedback
Zonka Feedback connector knowledge and safe action guide.
★ 7
pm-zoho-invoice
Zoho Invoice connector knowledge and safe action guide.
★ 7
pm-zoho-inventory
Zoho Inventory connector knowledge and safe action guide.
★ 7