konecty/konecty-meta-document
skills/konecty-meta-document/SKILL.md
Manage Konecty document metadata: show document definitions, list fields, add/remove/update fields, manage document events (queue/webhook). Use when the user wants to create or modify a document schema, add fields, manage field properties, or configure document-level events for queue/webhook integration. Requires admin credentials.
development
Updated May 1, 2026
$ install --global
skillsauthnpx skillsauth add konecty/skills konecty-meta-documentInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 1, 2026, 9:41 AM119.9s4 files scanned
SKILL.md
- name:
- konecty-meta-document
- description:
- Manage Konecty document metadata: show document definitions, list fields, add/remove/update fields, manage document events (queue/webhook). Use when the user wants to create or modify a document schema, add fields, manage field properties, or configure document-level events for queue/webhook integration. Requires admin credentials.
Konecty Meta Document
Manage document-type metadata definitions (fields, labels, events, indexes).
Prerequisites
Requires admin credentials from konecty-session. User must have admin: true.
API Endpoints
| Endpoint | Method | Description |
|----------|--------|-------------|
| /api/admin/meta/:document/document/:document | GET | Get full document meta |
| /api/admin/meta/:document/document/:document | PUT | Upsert document meta |
Workflow
1. Show a document definition
python3 scripts/meta_document.py show Contact
2. List fields
python3 scripts/meta_document.py fields Contact
python3 scripts/meta_document.py fields Contact --format json
3. Add a field
python3 scripts/meta_document.py add-field Contact myNewField \
--type text --label-en "My Field" --label-pt "Meu Campo" --required
4. Remove a field
python3 scripts/meta_document.py remove-field Contact myNewField
5. Update a field property
python3 scripts/meta_document.py update-field Contact status --set isRequired=true
python3 scripts/meta_document.py update-field Contact status --set 'label.en=Status Name'
6. Upsert full document
python3 scripts/meta_document.py upsert Contact --file document.json
7. List document events
python3 scripts/meta_document.py events Contact
Key concepts
fieldsis an object-map{ "fieldName": { ... } }, not an array- Field types: text, number, boolean, date, dateTime, picklist, lookup, email, phone, address, personName, money, file, composite, filter, richText, autoNumber, etc.
- See references/field-architecture.md for full field type documentation
- See references/document-events.md for queue/webhook event configuration
Script reference
See scripts/meta_document.py. Stdlib only.
Related Skills
konecty/template-skill
data-ai
VerifiedTrustedCommunity
Replace with description of the skill and when the agent should use it.
SKILL.mdUpdated May 1, 2026
konecty/konecty-upload
tools
VerifiedTrustedCommunity
Upload, list, and delete files in Konecty document fields via the file API. Use this skill whenever the user wants to attach a file to a Konecty record, upload a photo/image to a contact or product, add a PDF or document to an opportunity, send a curriculum to a candidate, manage gallery images for a development or promotion, or attach any binary file to any Konecty module field. Also triggers when the user says 'upload', 'anexar', 'enviar arquivo', 'adicionar imagem', 'attach file', or refers to file-type fields in any document. Automatically reads field constraints (accepted extensions, max size, max file count) from metadata before uploading to catch errors early. Requires an active konecty-session (KONECTY_URL and KONECTY_TOKEN in ~/.konecty/.env or ~/.konecty/credentials).
SKILL.mdUpdated May 1, 2026
konecty/konecty-update
documentation
VerifiedTrustedCommunity
Updates records in any Konecty module via PUT /rest/data/:document. Enforces the mandatory pre-update fetch workflow: always fetch the current record first to obtain its _updatedAt (optimistic locking guard), then PUT with ids=[{_id, _updatedAt}] and data={changed fields}. Use when the user wants to update, edit, change, or modify any record in Konecty. Requires an active konecty-session. Use konecty-modules to discover field names and types before updating.
SKILL.mdUpdated May 1, 2026
konecty/konecty-session
development
VerifiedTrustedCommunity
Opens a Konecty session via OTP login (request OTP, then verify OTP) and persists the access token in .env or ~/.konecty/credentials for use by other skills. Use when the user wants to log in to Konecty with OTP, store credentials, set up KONECTY_TOKEN, or establish a session so other Konecty skills can call the API. Only works when the namespace has OTP enabled (email or WhatsApp).
SKILL.mdUpdated May 1, 2026