@hailer/mcp 1.1.14 → 1.1.16

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

@@ -0,0 +1,184 @@
+# Hailer Activities API
+
+Execute Hailer activity (row) 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.
+
+---
+
+## Core Operations (v3)
+
+### Create Activity
+```bash
+curl -X POST "https://api.hailer.com/api/v3/activity/create" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["WORKFLOW_ID", {"name": "Activity Name", "fields": {"fieldId": "value"}}]'
+```
+
+### Create Many Activities
+```bash
+curl -X POST "https://api.hailer.com/api/v3/activity/createMany" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["WORKFLOW_ID", [{"name": "Activity 1"}, {"name": "Activity 2"}]]'
+```
+
+### Update Many Activities
+```bash
+curl -X POST "https://api.hailer.com/api/v3/activity/updateMany" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '[[{"_id": "ACTIVITY_ID", "name": "Updated Name", "fields": {"fieldId": "newValue"}}]]'
+```
+
+**GOTCHA:** All activities in the update array must belong to the same workflow. If updating activities across multiple workflows, make separate `updateMany` calls per workflow.
+
+### List Activities
+```bash
+curl -X POST "https://api.hailer.com/api/v3/activity/list" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '[{"processId": "WORKFLOW_ID", "phaseId": "PHASE_ID"}, {"limit": 50}]'
+```
+
+### Count Activities
+```bash
+curl -X POST "https://api.hailer.com/api/v3/activity/count" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["WORKFLOW_ID"]'
+```
+
+### Get Activity Permissions
+```bash
+curl -X POST "https://api.hailer.com/api/v3/activity/permissions" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["USER_ID", "WORKSPACE_ID"]'
+```
+
+---
+
+## Kanban Operations (v3)
+
+### Load Kanban for Activity
+```bash
+curl -X POST "https://api.hailer.com/api/v3/activity/kanban/load" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["ACTIVITY_ID"]'
+```
+
+### List Kanban Activities
+```bash
+curl -X POST "https://api.hailer.com/api/v3/activity/kanban/list" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["WORKFLOW_ID", {"phaseId": "PHASE_ID"}]'
+```
+
+---
+
+## Timeline & Events (v3)
+
+### Get Timeline
+```bash
+curl -X POST "https://api.hailer.com/api/v3/activity/timeline" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '[START_TIMESTAMP, END_TIMESTAMP, {"workflowIds": ["WF_ID"]}]'
+```
+
+### Get Events
+```bash
+curl -X POST "https://api.hailer.com/api/v3/activity/events" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '[START_TIMESTAMP, END_TIMESTAMP, {}]'
+```
+
+---
+
+## Linked Activities (v3)
+
+### Get Linked From Overview
+```bash
+curl -X POST "https://api.hailer.com/api/v3/activity/linkedFrom/overview" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["ACTIVITY_ID"]'
+```
+
+### Search Linked Activities
+```bash
+curl -X POST "https://api.hailer.com/api/v3/activity/linkedFrom/search" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["ACTIVITY_ID", "search term"]'
+```
+
+---
+
+## Deleted Activities (v3)
+
+### View Removed Activities
+```bash
+curl -X POST "https://api.hailer.com/api/v3/activity/removed/overview" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '[["PHASE_ID_1", "PHASE_ID_2"]]'
+```
+
+### Recover Removed Activities
+```bash
+curl -X POST "https://api.hailer.com/api/v3/activity/removed/recover" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '[["ACTIVITY_ID_1", "ACTIVITY_ID_2"]]'
+```
+
+---
+
+## Import (v3)
+
+### Import Activities from File
+```bash
+curl -X POST "https://api.hailer.com/api/v3/activity/import" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["FILE_ID", {"workflowId": "WF_ID", "phaseId": "PHASE_ID"}]'
+```
+
+---
+
+## Legacy Operations (v2) - Use if v3 not available
+
+### Copy Activities
+```bash
+curl -X POST "https://api.hailer.com/api/v2/activities/copy" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '[["ACTIVITY_ID_1", "ACTIVITY_ID_2"]]'
+```
+
+### Check Name Uniqueness
+```bash
+curl -X POST "https://api.hailer.com/api/v2/activities/nameIsUnique" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["WORKFLOW_ID", "Activity Name"]'
+```
+
+---
+
+## Notes
+- Timestamps are milliseconds since Unix epoch
+- Activity fields use fieldId as key, not field name
+- Phase determines activity state/status
+- workflowId = processId (legacy naming)

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

@@ -0,0 +1,473 @@
+# Hailer Admin API
+
+Execute Hailer workspace administration 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.
+
+---
+
+## Authentication & Session
+
+### Login (v3)
+```bash
+curl -X POST "https://api.hailer.com/api/v3/login" \
+  -H "Content-Type: application/json" \
+  -d '["user@email.com", "password"]'
+```
+Returns session key to use as `hlrkey` header.
+
+### Resume Session (v3)
+```bash
+curl -X POST "https://api.hailer.com/api/v3/resume" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '[]'
+```
+
+### Logout
+```bash
+curl -X POST "https://api.hailer.com/api/core/logout" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '[]'
+```
+
+### OAuth Logins (v3)
+```bash
+# Google
+curl -X POST "https://api.hailer.com/api/v3/loginGoogle" \
+  -H "Content-Type: application/json" \
+  -d '["GOOGLE_TOKEN"]'
+
+# Microsoft
+curl -X POST "https://api.hailer.com/api/v3/loginMicrosoft" \
+  -H "Content-Type: application/json" \
+  -d '["MICROSOFT_TOKEN"]'
+
+# Apple
+curl -X POST "https://api.hailer.com/api/v3/loginApple" \
+  -H "Content-Type: application/json" \
+  -d '["APPLE_TOKEN"]'
+```
+
+---
+
+## Workspace (Network) Management (v2)
+
+### Create Workspace
+```bash
+curl -X POST "https://api.hailer.com/api/v2/network/create" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '[{"name": "My Workspace"}]'
+```
+
+### Get Workspace
+```bash
+curl -X POST "https://api.hailer.com/api/v2/network/get" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["WORKSPACE_ID"]'
+```
+
+### Update Workspace
+```bash
+curl -X POST "https://api.hailer.com/api/v2/network/update" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["WORKSPACE_ID", {"name": "Updated Name", "description": "..."}]'
+```
+
+### Copy Workspace
+```bash
+curl -X POST "https://api.hailer.com/api/v2/network/copy" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["WORKSPACE_ID", {"name": "Copy of Workspace"}]'
+```
+
+### Get License Info
+```bash
+curl -X POST "https://api.hailer.com/api/v2/network/license/get" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["WORKSPACE_ID"]'
+```
+
+### Get Restrictions
+```bash
+curl -X POST "https://api.hailer.com/api/v2/network/restrictions" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["WORKSPACE_ID"]'
+```
+
+---
+
+## User Invitations (v2)
+
+### List Pending Invitations
+```bash
+curl -X POST "https://api.hailer.com/api/v2/network/invite/list" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["WORKSPACE_ID"]'
+```
+
+### Send Invitation
+```bash
+curl -X POST "https://api.hailer.com/api/v2/network/invite/send" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["WORKSPACE_ID", {"email": "user@email.com", "role": "member"}]'
+```
+
+### Resend Invitation
+```bash
+curl -X POST "https://api.hailer.com/api/v2/network/invite/resend" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["INVITE_ID"]'
+```
+
+### Edit Invitation
+```bash
+curl -X POST "https://api.hailer.com/api/v2/network/invite/edit" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["INVITE_ID", {"role": "admin"}]'
+```
+
+### Remove Invitation
+```bash
+curl -X POST "https://api.hailer.com/api/v2/network/invite/remove" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["INVITE_ID"]'
+```
+
+---
+
+## Roles (v3)
+
+### Create Role
+```bash
+curl -X POST "https://api.hailer.com/api/v3/network/role/create" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["WORKSPACE_ID", {"name": "Custom Role", "permissions": ["view", "edit"]}]'
+```
+
+### List Roles
+```bash
+curl -X POST "https://api.hailer.com/api/v3/network/role/list" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["WORKSPACE_ID"]'
+```
+
+### Update Role
+```bash
+curl -X POST "https://api.hailer.com/api/v3/network/role/update" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["ROLE_ID", {"name": "Updated Role", "permissions": ["view"]}]'
+```
+
+### Remove Role
+```bash
+curl -X POST "https://api.hailer.com/api/v3/network/role/remove" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["ROLE_ID"]'
+```
+
+---
+
+## Apps (v3)
+
+### Create App
+```bash
+curl -X POST "https://api.hailer.com/api/v3/app/create" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["WORKSPACE_ID", {"name": "My App", "url": "https://myapp.com"}]'
+```
+
+### List Apps
+```bash
+curl -X POST "https://api.hailer.com/api/v3/app/list" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["WORKSPACE_ID"]'
+```
+
+### Update App
+```bash
+curl -X POST "https://api.hailer.com/api/v3/app/update" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["APP_ID", {"name": "Updated App Name"}]'
+```
+
+### Remove App
+```bash
+curl -X POST "https://api.hailer.com/api/v3/app/remove" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["APP_ID"]'
+```
+
+### Add App Member
+```bash
+curl -X POST "https://api.hailer.com/api/v3/app/member/add" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["APP_ID", {"userId": "USER_ID"}]'
+```
+
+### Remove App Member
+```bash
+curl -X POST "https://api.hailer.com/api/v3/app/member/remove" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["APP_ID", {"userId": "USER_ID"}]'
+```
+
+### Update App Config
+```bash
+curl -X POST "https://api.hailer.com/api/v3/app/config/update" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["APP_ID", {"config": {"key": "value"}}]'
+```
+
+---
+
+## User Management
+
+### Load Current User
+```bash
+curl -X POST "https://api.hailer.com/api/user/load" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '[]'
+```
+
+### Update User Info
+```bash
+curl -X POST "https://api.hailer.com/api/user/set_user_info" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '[{"firstname": "John", "lastname": "Doe", "title": "Developer"}]'
+```
+
+### Save User Settings
+```bash
+curl -X POST "https://api.hailer.com/api/user/save_settings" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '[{"language": "en", "timezone": "Europe/Helsinki"}]'
+```
+
+### Change Password
+```bash
+curl -X POST "https://api.hailer.com/api/user/change_password" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["OLD_PASSWORD", "NEW_PASSWORD"]'
+```
+
+### Get User Profile (v2)
+```bash
+curl -X POST "https://api.hailer.com/api/v2/user/profile" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["USER_ID"]'
+```
+
+### Get User Permissions (v3)
+```bash
+curl -X POST "https://api.hailer.com/api/v3/user/permissions" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["USER_ID", "WORKSPACE_ID"]'
+```
+
+---
+
+## Registration (v3)
+
+### Register New User
+```bash
+curl -X POST "https://api.hailer.com/api/v3/user/register" \
+  -H "Content-Type: application/json" \
+  -d '[{"email": "user@email.com", "password": "password123", "firstname": "John", "lastname": "Doe"}]'
+```
+
+### Accept Invitation (v2)
+```bash
+curl -X POST "https://api.hailer.com/api/v2/user/invite/accept" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["INVITE_TOKEN"]'
+```
+
+---
+
+## Teams (Company)
+
+### Create Team
+```bash
+curl -X POST "https://api.hailer.com/api/company/create_team" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '[{"name": "Engineering", "cid": "WORKSPACE_ID"}]'
+```
+
+### Update Team
+```bash
+curl -X POST "https://api.hailer.com/api/company/set_team_data" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["TEAM_ID", {"name": "Updated Team Name"}]'
+```
+
+### Update Team Users
+```bash
+curl -X POST "https://api.hailer.com/api/company/update_team_users" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["TEAM_ID", {"add": ["USER_ID_1"], "remove": ["USER_ID_2"]}]'
+```
+
+### Remove Team
+```bash
+curl -X POST "https://api.hailer.com/api/company/remove_team" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["TEAM_ID"]'
+```
+
+---
+
+## Groups (Network Groups)
+
+### Create Group
+```bash
+curl -X POST "https://api.hailer.com/api/network/group/create" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '[{"name": "Partners", "cid": "WORKSPACE_ID"}]'
+```
+
+### Get Group
+```bash
+curl -X POST "https://api.hailer.com/api/network/group/get" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["GROUP_ID"]'
+```
+
+### Update Group
+```bash
+curl -X POST "https://api.hailer.com/api/network/group/update" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["GROUP_ID", {"name": "Updated Group"}]'
+```
+
+### Remove Group
+```bash
+curl -X POST "https://api.hailer.com/api/network/group/remove" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["GROUP_ID"]'
+```
+
+---
+
+## Files
+
+### Upload File
+```bash
+curl -X POST "https://api.hailer.com/upload" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -H "Content-Type: multipart/form-data" \
+  -F "data=@/path/to/file.pdf"
+```
+Returns `{"_id": "FILE_ID"}` on success.
+
+### List Files
+```bash
+curl -X POST "https://api.hailer.com/api/files/list" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '[{"cid": "WORKSPACE_ID"}]'
+```
+
+### Get File Properties
+```bash
+curl -X POST "https://api.hailer.com/api/files/get_file_properties" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["FILE_ID"]'
+```
+
+### Remove Files
+```bash
+curl -X POST "https://api.hailer.com/api/files/remove_files" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '[["FILE_ID_1", "FILE_ID_2"]]'
+```
+
+---
+
+## Tags (v2)
+
+### List Tags
+```bash
+curl -X POST "https://api.hailer.com/api/v2/tags/list" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["WORKSPACE_ID"]'
+```
+
+### Add Tag
+```bash
+curl -X POST "https://api.hailer.com/api/v2/tags/manage/add" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["WORKSPACE_ID", {"name": "Important", "color": "#FF0000"}]'
+```
+
+### Tag an Object
+```bash
+curl -X POST "https://api.hailer.com/api/v2/tags/tag" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["OBJECT_ID", "TAG_ID"]'
+```
+
+### Untag an Object
+```bash
+curl -X POST "https://api.hailer.com/api/v2/tags/untag" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["OBJECT_ID", "TAG_ID"]'
+```
+
+---
+
+## Notes
+- Workspace = Network = Company (legacy naming)
+- Teams are internal groups within a workspace
+- Groups (network groups) can include external users
+- All IDs are 24-character MongoDB ObjectIds
+- Session keys expire after inactivity