konecty/konecty-delete
skills/konecty-delete/SKILL.md
Deletes a single record in any Konecty module via DELETE /rest/data/:document. Enforces a mandatory safety workflow: preview the record first, then delete one at a time with an explicit --confirm flag. Use when the user wants to delete, remove, or erase a record in Konecty. NEVER delete multiple records in a single operation. NEVER skip the preview step. Requires an active konecty-session.
testing
Updated May 1, 2026
$ install --global
skillsauthnpx skillsauth add konecty/skills konecty-deleteInstall 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:44 AM330.7s2 files scanned
SKILL.md
- name:
- konecty-delete
- description:
- Deletes a single record in any Konecty module via DELETE /rest/data/:document. Enforces a mandatory safety workflow: preview the record first, then delete one at a time with an explicit --confirm flag. Use when the user wants to delete, remove, or erase a record in Konecty. NEVER delete multiple records in a single operation. NEVER skip the preview step. Requires an active konecty-session.
Konecty Delete
Permanently remove one record at a time. Always preview before deleting.
⚠️ Irreversibility
Deletion in Konecty archives the record to a .Trash collection and hard-deletes it from the main collection. It cannot be restored via the standard API.
Mandatory Safety Rules
- One record at a time — batch deletion is not supported by this skill. Period.
- Preview first — always run
previewbeforedeleteto confirm the right record. - Explicit
--confirm— thedeletecommand is refused without the flag. - Never invent
_updatedAt— the script fetches it live; a stale value is rejected server-side.
Workflow
Step 1 — Preview the record
python3 skills/konecty-delete/scripts/delete.py preview <Document> <code or _id>
Shows the full record with a warning. Prints the exact delete command to run next.
Step 2 — Delete with confirmation
python3 skills/konecty-delete/scripts/delete.py delete <Document> <code or _id> --confirm
The script fetches the live _updatedAt, displays the record one final time, then executes the deletion.
Examples
Delete a test message
# Step 1: inspect
python3 skills/konecty-delete/scripts/delete.py preview Message wyLtwR3aRntZ4a2q8
# Step 2: confirm and delete
python3 skills/konecty-delete/scripts/delete.py delete Message wyLtwR3aRntZ4a2q8 --confirm
Delete a contact by code
python3 skills/konecty-delete/scripts/delete.py preview Contact 16503
python3 skills/konecty-delete/scripts/delete.py delete Contact 16503 --confirm
Server-Side Guards (Konecty enforces automatically)
| Guard | Description |
|-------|-------------|
| Permission | User must have isDeletable access on the module |
| _updatedAt locking | Must match the live record — stale value = rejection |
| Foreign key check | Blocks deletion if other records reference this one |
| Scope filter | User can only delete records within their deleteFilter scope |
Common Errors and Actions
| Error | Cause | Action |
|-------|-------|--------|
| --confirm flag is required | Flag omitted | Add --confirm after reviewing preview |
| There are new version for records: ... | Record changed after fetch | Run preview again to get the latest version |
| Cannot delete records ... because they are referenced by [Module] | FK constraint | Remove or update the referencing records first |
| You don't have permission to delete records | No isDeletable access | Check user permissions or ask an admin |
| or they don't exists | Wrong _id / outside scope | Verify the record exists via konecty-find |
Script Reference
See scripts/delete.py. Stdlib only.
delete.py preview <Document> <term> # inspect — no changes
delete.py delete <Document> <term> --confirm # irreversible deletion
term is a numeric code or exact _id. All subcommands accept --host and --token.
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