Recommendations are a relevance-ordered list of documents suggested for a user. The resource is served by the Files API; public URLs use the /files/ prefix.

The userId in the path must be the currently authenticated user; you cannot request another user’s list.

Optional query keys (present on the URI template only; not used to slice results in the current implementation): page, pagesize.

GET /files/documents/recommendations/123 HTTP/1.1
Accept: application/vnd.huddle.data+xml
Authorization: Bearer frootymcnooty/vonbootycherooty

HTTP/1.1 200 OK
Content-Type: application/vnd.huddle.data+xml

<recommendations>
  <link rel="self" href="https://api.example.com/files/documents/recommendations/123" />
  <recommendation>
    <document>
      <link rel="self" href="https://api.example.com/files/documents/1001" />
    </document>
  </recommendation>
  <recommendation>
    <document>
      <link rel="self" href="https://api.example.com/files/documents/1002" />
    </document>
  </recommendation>
</recommendations>

Each recommendation uses the compact shape: a document element whose link entries identify the document (typically rel="self"). Titles, descriptions, and workspace blocks are not emitted by the current Files API view builder (a fuller RecommendationFullView type exists in code but is not used for this endpoint today).

HTTP/1.1 204 No Content

GET /files/documents/recommendations/123 HTTP/1.1
Accept: application/vnd.huddle.data+json
Authorization: Bearer frootymcnooty/vonbootycherooty

HTTP/1.1 200 OK
Content-Type: application/vnd.huddle.data+json

{
  "links": [
    { "rel": "self", "href": "https://api.example.com/files/documents/recommendations/123" }
  ],
  "recommendations": [
    {
      "document": {
        "links": [
          { "rel": "self", "href": "https://api.example.com/files/documents/1001" }
        ]
      }
    },
    {
      "document": {
        "links": [
          { "rel": "self", "href": "https://api.example.com/files/documents/1002" }
        ]
      }
    }
  ]
}

Responses may be cacheable per Files API policy (private, short max-age in typical setups).

recommendations = element recommendations {
  link+,
  recommendation*
}

recommendation = element recommendation {
  element document {
    link+
  }
}

• Document — full document representation behind each self link