@hailer/mcp 1.1.16 → 1.1.17-beta.0

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

@@ -1,473 +0,0 @@
-# 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