GET /entity/human_users/<user_id>/following
get_entity_human_users_id_following
Everything one HumanUser follows, unpaged in a single body, filterable only by entity and project_id. An ApiUser id is a 404, so a script has no follow list of its own.
API
Params
| part | value |
|---|---|
<user_id> |
a HumanUser id. Any other user type is a 404 |
entity |
one type to keep. Note and notes both work |
project_id |
keep only rows in that project |
No fields, no page[], no sort.
Sample requests
r = c.get("/entity/human_users/3/following")
{
"data": [
{"id": 346, "type": "Note", "links": {"self": "/api/v1/entity/Note/346"}},
{"id": 360, "type": "Note", "links": {"self": "/api/v1/entity/Note/360"}},
{"id": 391, "type": "Note", "links": {"self": "/api/v1/entity/Note/391"}}
]
}
On the probed site that call answered 896 rows in one body, 707 Note and 189 Task, with no page
key. The two filters cut it server-side:
c.get("/entity/human_users/3/following", params={"entity": "notes"}) # 707 rows
c.get("/entity/human_users/3/following", params={"entity": "Note"}) # 707 rows
c.get("/entity/human_users/3/following", params={"entity": "shots"}) # 0 rows
c.get("/entity/human_users/3/following", params={"project_id": 70}) # 865 rows
c.get("/entity/human_users/3/following", params={"entity": "notes", "project_id": 70}) # 707 rows
Response codes
| status | when |
|---|---|
| 200 | the list, [] when the user follows nothing matching |
| 400 | source: {"entity": ["entity is not valid"]} |
| 404 | detail: "Couldn't find HumanUser with id=\"999999999\"" |
| 404 | detail: "Couldn't find Project with id=\"999999999\"" for an unknown project_id |
Edge cases
- An ApiUser id under
/entity/human_users/answersCouldn't find HumanUser with id="1". A script token cannot ask what it follows, only what a named person follows. entitytakes the schema name or the snake_case plural, unlike theentitykey in thefollowbody, which takes the schema name alone and answers 500 to the plural.links.selfis/api/v1/entity/Note/346, singular and CamelCase, matchingendpoints/get_entity_type_id_followersand nothing else in the API. It resolves at 200.- Each row is id, type and a link. Neither the name of the followed record nor the date the follow
started is returned, so a display list costs one call per row or a
_searchon the ids. - Nothing pages. Filter with
entityandproject_idor take the whole list.