@hailer/mcp 1.1.16 → 1.1.17-beta.0

package/.claude/skills/hailer-rest-api/hailer-messaging.md

@@ -1,276 +0,0 @@
-# Hailer Messaging API
-
-Execute Hailer discussion and messenger operations via REST API.
-
-## Base URL
-- **Production:** `https://api.hailer.com/api`
-- **Staging:** `https://api.hailer.biz/api`
-
-## Authentication
-All requests require `hlrkey` header with session key.
-
----
-
-## Send Messages
-
-### Send Message to Discussion
-```bash
-curl -X POST "https://api.hailer.com/api/messenger/send" \
-  -H "Content-Type: application/json" \
-  -H "hlrkey: YOUR_SESSION_KEY" \
-  -d '[{"discussionId": "DISCUSSION_ID", "text": "Hello world!", "files": []}]'
-```
-
-### Send with File Attachments
-```bash
-curl -X POST "https://api.hailer.com/api/messenger/send" \
-  -H "Content-Type: application/json" \
-  -H "hlrkey: YOUR_SESSION_KEY" \
-  -d '[{"discussionId": "DISCUSSION_ID", "text": "See attachment", "files": ["FILE_ID_1", "FILE_ID_2"]}]'
-```
-
----
-
-## Load Messages
-
-### Load Messages from Discussion
-```bash
-curl -X POST "https://api.hailer.com/api/messenger/load_messages" \
-  -H "Content-Type: application/json" \
-  -H "hlrkey: YOUR_SESSION_KEY" \
-  -d '[{"discussionId": "DISCUSSION_ID", "limit": 50}]'
-```
-
-### Get Specific Message (v3)
-```bash
-curl -X POST "https://api.hailer.com/api/v3/discussion/message/get" \
-  -H "Content-Type: application/json" \
-  -H "hlrkey: YOUR_SESSION_KEY" \
-  -d '["MESSAGE_ID"]'
-```
-
-### Get Latest Messages (v3)
-```bash
-curl -X POST "https://api.hailer.com/api/v3/discussion/message/latest" \
-  -H "Content-Type: application/json" \
-  -H "hlrkey: YOUR_SESSION_KEY" \
-  -d '["DISCUSSION_ID", {"limit": 20}]'
-```
-
-### Get Next/Previous Messages (v3)
-```bash
-# Next (newer)
-curl -X POST "https://api.hailer.com/api/v3/discussion/message/next" \
-  -H "Content-Type: application/json" \
-  -H "hlrkey: YOUR_SESSION_KEY" \
-  -d '["DISCUSSION_ID", "AFTER_MESSAGE_ID", {"limit": 20}]'
-
-# Previous (older)
-curl -X POST "https://api.hailer.com/api/v3/discussion/message/previous" \
-  -H "Content-Type: application/json" \
-  -H "hlrkey: YOUR_SESSION_KEY" \
-  -d '["DISCUSSION_ID", "BEFORE_MESSAGE_ID", {"limit": 20}]'
-```
-
----
-
-## Edit & Delete Messages (v2)
-
-### Edit Message
-```bash
-curl -X POST "https://api.hailer.com/api/v2/discussion/message/edit" \
-  -H "Content-Type: application/json" \
-  -H "hlrkey: YOUR_SESSION_KEY" \
-  -d '["MESSAGE_ID", "Updated message text"]'
-```
-
-### Delete Message
-```bash
-curl -X POST "https://api.hailer.com/api/v2/discussion/message/delete" \
-  -H "Content-Type: application/json" \
-  -H "hlrkey: YOUR_SESSION_KEY" \
-  -d '["MESSAGE_ID"]'
-```
-
-### React to Message (v2)
-```bash
-curl -X POST "https://api.hailer.com/api/v2/discussion/message/react" \
-  -H "Content-Type: application/json" \
-  -H "hlrkey: YOUR_SESSION_KEY" \
-  -d '["MESSAGE_ID", "emoji_name"]'
-# Common reactions: thumbsup, heart, laugh, etc.
-```
-
----
-
-## Discussion Management
-
-### Load All Discussions
-```bash
-curl -X POST "https://api.hailer.com/api/messenger/load_discussions" \
-  -H "Content-Type: application/json" \
-  -H "hlrkey: YOUR_SESSION_KEY" \
-  -d '[{}]'
-```
-
-### Find User Discussion (DM)
-```bash
-curl -X POST "https://api.hailer.com/api/messenger/find_user_discussion" \
-  -H "Content-Type: application/json" \
-  -H "hlrkey: YOUR_SESSION_KEY" \
-  -d '["USER_ID"]'
-```
-
-### Sync Discussion (v2)
-```bash
-curl -X POST "https://api.hailer.com/api/v2/discussion/sync" \
-  -H "Content-Type: application/json" \
-  -H "hlrkey: YOUR_SESSION_KEY" \
-  -d '["DISCUSSION_ID"]'
-```
-
-### Get Discussion Files (v3)
-```bash
-curl -X POST "https://api.hailer.com/api/v3/discussion/files" \
-  -H "Content-Type: application/json" \
-  -H "hlrkey: YOUR_SESSION_KEY" \
-  -d '["DISCUSSION_ID", {"limit": 50}]'
-```
-
----
-
-## Discussion Participants
-
-### Invite Users to Discussion
-```bash
-curl -X POST "https://api.hailer.com/api/messenger/invite_users" \
-  -H "Content-Type: application/json" \
-  -H "hlrkey: YOUR_SESSION_KEY" \
-  -d '[{"discussionId": "DISCUSSION_ID", "userIds": ["USER_ID_1", "USER_ID_2"]}]'
-```
-
-### Leave Discussion
-```bash
-curl -X POST "https://api.hailer.com/api/messenger/leave_discussion" \
-  -H "Content-Type: application/json" \
-  -H "hlrkey: YOUR_SESSION_KEY" \
-  -d '["DISCUSSION_ID"]'
-```
-
----
-
-## Stars & Bookmarks
-
-### Star/Unstar Discussion (v2)
-```bash
-curl -X POST "https://api.hailer.com/api/v2/discussion/star" \
-  -H "Content-Type: application/json" \
-  -H "hlrkey: YOUR_SESSION_KEY" \
-  -d '["DISCUSSION_ID"]'
-```
-
-### Star/Unstar Message (v3)
-```bash
-curl -X POST "https://api.hailer.com/api/v3/discussion/message/star" \
-  -H "Content-Type: application/json" \
-  -H "hlrkey: YOUR_SESSION_KEY" \
-  -d '["MESSAGE_ID"]'
-```
-
-### Get Starred Messages (v3)
-```bash
-curl -X POST "https://api.hailer.com/api/v3/discussion/message/stars" \
-  -H "Content-Type: application/json" \
-  -H "hlrkey: YOUR_SESSION_KEY" \
-  -d '["DISCUSSION_ID"]'
-```
-
----
-
-## Read Status & Notifications
-
-### Mark as Read
-```bash
-curl -X POST "https://api.hailer.com/api/messenger/set_discussion_last_seen" \
-  -H "Content-Type: application/json" \
-  -H "hlrkey: YOUR_SESSION_KEY" \
-  -d '["DISCUSSION_ID", TIMESTAMP_MS]'
-```
-
-### Get Unread Count
-```bash
-curl -X POST "https://api.hailer.com/api/messenger/get_unread_count" \
-  -H "Content-Type: application/json" \
-  -H "hlrkey: YOUR_SESSION_KEY" \
-  -d '[]'
-```
-
-### Mute/Unmute Discussion (v2)
-```bash
-curl -X POST "https://api.hailer.com/api/v2/discussion/mute" \
-  -H "Content-Type: application/json" \
-  -H "hlrkey: YOUR_SESSION_KEY" \
-  -d '["DISCUSSION_ID", true]'
-# true = mute, false = unmute
-```
-
----
-
-## Settings & Permissions
-
-### Save Discussion Settings
-```bash
-curl -X POST "https://api.hailer.com/api/messenger/save_discussion_settings" \
-  -H "Content-Type: application/json" \
-  -H "hlrkey: YOUR_SESSION_KEY" \
-  -d '["DISCUSSION_ID", {"name": "New Discussion Name"}]'
-```
-
-### Set Discussion Permission (v3)
-```bash
-curl -X POST "https://api.hailer.com/api/v3/discussion/setPermission" \
-  -H "Content-Type: application/json" \
-  -H "hlrkey: YOUR_SESSION_KEY" \
-  -d '["DISCUSSION_ID", {"permission": "write", "target": {"userId": "USER_ID"}}]'
-```
-
-### Close Discussion (v3)
-```bash
-curl -X POST "https://api.hailer.com/api/v3/discussion/close" \
-  -H "Content-Type: application/json" \
-  -H "hlrkey: YOUR_SESSION_KEY" \
-  -d '["DISCUSSION_ID"]'
-```
-
----
-
-## Typing Indicator
-
-### Set Typing State
-```bash
-curl -X POST "https://api.hailer.com/api/messenger/set_discussion_typing_state" \
-  -H "Content-Type: application/json" \
-  -H "hlrkey: YOUR_SESSION_KEY" \
-  -d '["DISCUSSION_ID", true]'
-# true = typing, false = stopped
-```
-
----
-
-## Video Meetings (v2)
-
-### Start Meet
-```bash
-curl -X POST "https://api.hailer.com/api/v2/discussion/meet/start" \
-  -H "Content-Type: application/json" \
-  -H "hlrkey: YOUR_SESSION_KEY" \
-  -d '["DISCUSSION_ID"]'
-```
-
----
-
-## Notes
-- Every activity has an associated discussion (same ID)
-- Discussions can be standalone (group chats) or linked to activities
-- Timestamps are milliseconds since Unix epoch
-- Files must be uploaded first via `/upload` endpoint, then attached by ID

package/.claude/skills/hailer-rest-api/hailer-workflows.md

@@ -1,283 +0,0 @@
-# Hailer Workflows API
-
-Execute Hailer workflow (process/table) operations via REST API.
-
-## Base URL
-- **Production:** `https://api.hailer.com/api`
-- **Staging:** `https://api.hailer.biz/api`
-
-## Authentication
-All requests require `hlrkey` header with session key.
-
----
-
-## Workflow CRUD
-
-### Create Workflow
-```bash
-curl -X POST "https://api.hailer.com/api/process/create" \
-  -H "Content-Type: application/json" \
-  -H "hlrkey: YOUR_SESSION_KEY" \
-  -d '[{"name": "My Workflow", "cid": "WORKSPACE_ID"}]'
-```
-
-### Get Workflow
-```bash
-curl -X POST "https://api.hailer.com/api/v2/process/get" \
-  -H "Content-Type: application/json" \
-  -H "hlrkey: YOUR_SESSION_KEY" \
-  -d '["WORKFLOW_ID"]'
-```
-
-### List Workflows
-```bash
-curl -X POST "https://api.hailer.com/api/process/list" \
-  -H "Content-Type: application/json" \
-  -H "hlrkey: YOUR_SESSION_KEY" \
-  -d '[]'
-```
-
-### Update Workflow Info
-```bash
-curl -X POST "https://api.hailer.com/api/process/set_info" \
-  -H "Content-Type: application/json" \
-  -H "hlrkey: YOUR_SESSION_KEY" \
-  -d '["WORKFLOW_ID", {"name": "New Name", "description": "Updated description"}]'
-```
-
-### Remove Workflow
-```bash
-curl -X POST "https://api.hailer.com/api/process/remove" \
-  -H "Content-Type: application/json" \
-  -H "hlrkey: YOUR_SESSION_KEY" \
-  -d '["WORKFLOW_ID"]'
-```
-
-### Copy Workflow
-```bash
-curl -X POST "https://api.hailer.com/api/v2/process/copy" \
-  -H "Content-Type: application/json" \
-  -H "hlrkey: YOUR_SESSION_KEY" \
-  -d '[{"processIds": ["WORKFLOW_ID"]}]'
-```
-
-### Star/Unstar Workflow
-```bash
-curl -X POST "https://api.hailer.com/api/v2/process/star" \
-  -H "Content-Type: application/json" \
-  -H "hlrkey: YOUR_SESSION_KEY" \
-  -d '["WORKFLOW_ID"]'
-```
-
----
-
-## Field Operations
-
-### Create Field
-```bash
-curl -X POST "https://api.hailer.com/api/process/create_field" \
-  -H "Content-Type: application/json" \
-  -H "hlrkey: YOUR_SESSION_KEY" \
-  -d '["WORKFLOW_ID", {"name": "Field Name", "type": "text", "order": 1}]'
-```
-
-Field types (from hailer.d.ts): `text`, `textarea`, `textunit`, `numeric`, `numericunit`, `date`, `datetime`, `daterange`, `datetimerange`, `time`, `timerange`, `textpredefinedoptions`, `users`, `teams`, `activitylink`, `linkedfrom`, `country`, `subheader`
-
-### Update Field
-```bash
-curl -X POST "https://api.hailer.com/api/process/update_field" \
-  -H "Content-Type: application/json" \
-  -H "hlrkey: YOUR_SESSION_KEY" \
-  -d '["WORKFLOW_ID", "FIELD_ID", {"name": "Updated Name", "required": true}]'
-```
-
-### Remove Field
-```bash
-curl -X POST "https://api.hailer.com/api/process/remove_field" \
-  -H "Content-Type: application/json" \
-  -H "hlrkey: YOUR_SESSION_KEY" \
-  -d '["WORKFLOW_ID", "FIELD_ID"]'
-```
-
----
-
-## Phase Operations
-
-### Create Phase
-```bash
-curl -X POST "https://api.hailer.com/api/phase/create" \
-  -H "Content-Type: application/json" \
-  -H "hlrkey: YOUR_SESSION_KEY" \
-  -d '[{"processId": "WORKFLOW_ID", "name": "New Phase", "order": 1}]'
-```
-
-### Update Phase
-```bash
-curl -X POST "https://api.hailer.com/api/phase/update" \
-  -H "Content-Type: application/json" \
-  -H "hlrkey: YOUR_SESSION_KEY" \
-  -d '["PHASE_ID", {"name": "Updated Phase", "color": "#FF5733"}]'
-```
-
-### Remove Phase
-```bash
-curl -X POST "https://api.hailer.com/api/phase/remove" \
-  -H "Content-Type: application/json" \
-  -H "hlrkey: YOUR_SESSION_KEY" \
-  -d '["PHASE_ID"]'
-```
-
-### Set Phase Info
-```bash
-curl -X POST "https://api.hailer.com/api/phase/set_info" \
-  -H "Content-Type: application/json" \
-  -H "hlrkey: YOUR_SESSION_KEY" \
-  -d '["PHASE_ID", {"description": "Phase description"}]'
-```
-
----
-
-## Workflow Members & Permissions (v2)
-
-### List Members
-```bash
-curl -X POST "https://api.hailer.com/api/v2/process/member/list" \
-  -H "Content-Type: application/json" \
-  -H "hlrkey: YOUR_SESSION_KEY" \
-  -d '["WORKFLOW_ID"]'
-```
-
-### Add Member
-```bash
-curl -X POST "https://api.hailer.com/api/v2/process/member/add" \
-  -H "Content-Type: application/json" \
-  -H "hlrkey: YOUR_SESSION_KEY" \
-  -d '["WORKFLOW_ID", {"userId": "USER_ID"}]'
-# Or for team: {"teamId": "TEAM_ID"}
-```
-
-### Remove Member
-```bash
-curl -X POST "https://api.hailer.com/api/v2/process/member/remove" \
-  -H "Content-Type: application/json" \
-  -H "hlrkey: YOUR_SESSION_KEY" \
-  -d '["WORKFLOW_ID", {"userId": "USER_ID"}]'
-```
-
-### Grant Permission
-```bash
-curl -X POST "https://api.hailer.com/api/v2/process/permissions/grant" \
-  -H "Content-Type: application/json" \
-  -H "hlrkey: YOUR_SESSION_KEY" \
-  -d '["WORKFLOW_ID", {"userId": "USER_ID"}, "edit"]'
-# Permissions: view, edit, admin
-```
-
-### Deny Permission
-```bash
-curl -X POST "https://api.hailer.com/api/v2/process/permissions/deny" \
-  -H "Content-Type: application/json" \
-  -H "hlrkey: YOUR_SESSION_KEY" \
-  -d '["WORKFLOW_ID", {"userId": "USER_ID"}, "edit"]'
-```
-
----
-
-## Phase Members & Permissions (v2)
-
-### List Phase Members
-```bash
-curl -X POST "https://api.hailer.com/api/v2/process/phase/member/list" \
-  -H "Content-Type: application/json" \
-  -H "hlrkey: YOUR_SESSION_KEY" \
-  -d '["PHASE_ID"]'
-```
-
-### Add Phase Member
-```bash
-curl -X POST "https://api.hailer.com/api/v2/process/phase/member/add" \
-  -H "Content-Type: application/json" \
-  -H "hlrkey: YOUR_SESSION_KEY" \
-  -d '["PHASE_ID", {"userId": "USER_ID"}]'
-```
-
-### Grant Phase Permission
-```bash
-curl -X POST "https://api.hailer.com/api/v2/process/phase/permissions/grant" \
-  -H "Content-Type: application/json" \
-  -H "hlrkey: YOUR_SESSION_KEY" \
-  -d '["PHASE_ID", {"userId": "USER_ID"}, "edit"]'
-```
-
----
-
-## Templates
-
-### Install Template
-```bash
-curl -X POST "https://api.hailer.com/api/process/install_template" \
-  -H "Content-Type: application/json" \
-  -H "hlrkey: YOUR_SESSION_KEY" \
-  -d '["TEMPLATE_ID"]'
-```
-
-### Create Activity Template
-```bash
-curl -X POST "https://api.hailer.com/api/v3/activity/template/create" \
-  -H "Content-Type: application/json" \
-  -H "hlrkey: YOUR_SESSION_KEY" \
-  -d '["WORKFLOW_ID", "PHASE_ID"]'
-```
-
----
-
-## Public Forms (v2)
-
-### Create Public Form
-```bash
-curl -X POST "https://api.hailer.com/api/v2/process/publicForm/create" \
-  -H "Content-Type: application/json" \
-  -H "hlrkey: YOUR_SESSION_KEY" \
-  -d '[{"processId": "WORKFLOW_ID", "phaseId": "PHASE_ID", "fields": ["FIELD_ID_1"]}]'
-```
-
-### Update Public Form
-```bash
-curl -X POST "https://api.hailer.com/api/v2/process/publicForm/update" \
-  -H "Content-Type: application/json" \
-  -H "hlrkey: YOUR_SESSION_KEY" \
-  -d '[{"formId": "FORM_ID", "enabled": true}]'
-```
-
----
-
-## Document Templates
-
-### Set Document Templates
-```bash
-curl -X POST "https://api.hailer.com/api/process/set_documentTemplates" \
-  -H "Content-Type: application/json" \
-  -H "hlrkey: YOUR_SESSION_KEY" \
-  -d '["WORKFLOW_ID", {"template1": {"name": "Invoice", "content": "..."}}]'
-```
-
----
-
-## Translations (v2)
-
-### Create Translation
-```bash
-curl -X POST "https://api.hailer.com/api/v2/process/translation/create" \
-  -H "Content-Type: application/json" \
-  -H "hlrkey: YOUR_SESSION_KEY" \
-  -d '["WORKFLOW_ID", "fi"]'
-# ISO language codes: en, fi, sv, de, etc.
-```
-
----
-
-## Notes
-- workflowId = processId (legacy naming)
-- cid = companyId = workspaceId = networkId (all refer to workspace)
-- Phases are like columns in a Kanban or row states
-- Fields are columns in the workflow table