{
  "schema_version": "1",
  "name": "SocialSphere",
  "site": "https://social.globalbr.ai",
  "repo": "https://github.com/tmad4000/SocialNetworkApp",
  "release": {
    "version": "1.4.0",
    "updated_at": "2026-07-25 07:04 AM PDT"
  },
  "auth": {
    "session": {
      "type": "cookie",
      "description": "Browser session cookie from POST /api/login."
    },
    "agent_key": {
      "type": "bearer",
      "header": "Authorization: Bearer social_...",
      "compatibility_header": "X-Agent-Key: social_...",
      "description": "Per-user revocable key. A valid key acts as its owning user on the supported v1.4 endpoints only. Agent-key management (/api/agent-keys) is browser-session-only and rejects agent keys."
    }
  },
  "templates": {
    "human_profile": "https://social.globalbr.ai/p/{username}",
    "json_profile": "https://social.globalbr.ai/api/profile-home/{username}"
  },
  "entities": {
    "profile_home_item": {
      "kinds": [
        "heading",
        "link",
        "note"
      ],
      "privacy": [
        "public",
        "friends",
        "private"
      ]
    }
  },
  "endpoints": [
    {
      "method": "GET",
      "path": "/api/meta",
      "summary": "Public release metadata and discovery links.",
      "auth": "none"
    },
    {
      "method": "GET",
      "path": "/api/me",
      "summary": "Safe profile of the effective authenticated actor.",
      "auth": "session_or_agent"
    },
    {
      "method": "GET",
      "path": "/api/profile-home/{username}",
      "summary": "Viewer-aware personal homepage for a user.",
      "auth": "none"
    },
    {
      "method": "GET",
      "path": "/api/profile-home/me",
      "summary": "The authenticated owner's full homepage, including private rows.",
      "auth": "session_or_agent"
    },
    {
      "method": "POST",
      "path": "/api/profile-home/items",
      "summary": "Create a homepage row.",
      "auth": "session_or_agent"
    },
    {
      "method": "PATCH",
      "path": "/api/profile-home/items/{id}",
      "summary": "Update an owned homepage row.",
      "auth": "session_or_agent"
    },
    {
      "method": "DELETE",
      "path": "/api/profile-home/items/{id}",
      "summary": "Delete an owned homepage row.",
      "auth": "session_or_agent"
    },
    {
      "method": "PUT",
      "path": "/api/profile-home/reorder",
      "summary": "Reorder owned homepage rows in a single transaction.",
      "auth": "session_or_agent"
    },
    {
      "method": "GET",
      "path": "/api/agent-keys",
      "summary": "List agent-key metadata for the authenticated owner.",
      "auth": "session_only"
    },
    {
      "method": "POST",
      "path": "/api/agent-keys",
      "summary": "Mint an agent key; the raw key is returned exactly once.",
      "auth": "session_only"
    },
    {
      "method": "DELETE",
      "path": "/api/agent-keys/{id}",
      "summary": "Revoke an owned agent key.",
      "auth": "session_only"
    }
  ],
  "discovery": {
    "llms_txt": "/llms.txt",
    "agents_md": "/AGENTS.md",
    "well_known": "/.well-known/socialsphere.json",
    "openapi": "/openapi.json",
    "robots": "/robots.txt",
    "agents_guide": "/agents",
    "api_docs": "/api-docs",
    "human_profile_template": "/p/{username}",
    "json_profile_template": "/api/profile-home/{username}"
  },
  "mcp": {
    "status": "not_available"
  }
}