{
  "schema_version": "v1",
  "name_for_human": "Whrami Location Sharing",
  "name_for_model": "whrami_location_api",
  "description_for_human": "Privacy-first location sharing for tracking people, sending GPS coordinates, and coordinating meetups. No personal information required.",
  "description_for_model": "API for GPS location tracking and sharing. Allows AI agents to: register devices, update/retrieve human locations, send location messages, manage markers (static locations), and handle contact relationships. Perfect for fleet tracking, delivery coordination, IoT devices, and event management. Uses anonymous user IDs with device authentication (X-User-Id and X-Registration-Key headers).",
  "auth": {
    "type": "user_http",
    "authorization_type": "custom",
    "custom_auth_header": "X-User-Id",
    "instructions": "First call POST /api/Contacts/RegisterContact with your chosen userId and deviceId to receive a registrationKey. Then include X-User-Id and X-Registration-Key headers in all subsequent requests."
  },
  "api": {
    "type": "openapi",
    "url": "https://whrami.com/swagger/v1/swagger.json",
    "has_user_authentication": true
  },
  "logo_url": "https://whrami.com/images/Wharmi_dark.png",
  "contact_email": "support@whrami.com",
  "legal_info_url": "https://whrami.com/terms",
  "capabilities": {
    "location_tracking": {
      "description": "Update and retrieve real-time GPS locations for registered users",
      "endpoints": [
        "POST /api/HumanLocation/UpdateHumanLocation",
        "GET /api/HumanLocation/GetHumanLocation"
      ]
    },
    "location_messaging": {
      "description": "Send and receive GPS coordinate messages for meetup points or item locations",
      "endpoints": [
        "POST /api/HumanLocation/SendLocationsMessage",
        "GET /api/HumanLocation/GetLocationMessages"
      ]
    },
    "static_markers": {
      "description": "Save and retrieve static location markers (meeting points, landmarks, etc.)",
      "endpoints": [
        "POST /api/Markers/SendMarkerLocation",
        "GET /api/Markers/GetMarkers"
      ]
    },
    "contact_management": {
      "description": "Manage follow requests and contact relationships between users",
      "endpoints": [
        "POST /api/Contacts/SendContactRequest",
        "GET /api/Contacts/GetContactRequests",
        "POST /api/Contacts/AcceptContactRequest",
        "POST /api/Contacts/DeclineContactRequest"
      ]
    },
    "device_registration": {
      "description": "Register devices and manage authentication tokens",
      "endpoints": [
        "POST /api/Contacts/RegisterContact",
        "POST /api/Contacts/RefreshToken",
        "POST /api/Contacts/RevokeDevice"
      ]
    }
  },
  "privacy_policy": {
    "anonymous_ids": true,
    "no_personal_info": true,
    "user_controlled": true,
    "description": "Whrami uses anonymous user IDs only. No email, phone, or personal information required. Users control who sees their location and can pause sharing anytime."
  },
  "use_cases": [
    "Fleet management and vehicle tracking",
    "Delivery agent coordination and ETA sharing",
    "IoT device location monitoring",
    "Event coordination and meetup planning",
    "Emergency response and dispatch",
    "Asset tracking with GPS-enabled devices",
    "Field technician location updates",
    "Care worker visit coordination"
  ],
  "getting_started_url": "https://whrami.com/ApiDocs",
  "documentation_url": "https://whrami.com/api/docs"
}