The Protected API lets your app act for one Mediux user, within the
permissions they approved. Routes live on
https://api.mediux.io under /account, /notifications and /relationships.
Before you start
Section titled “Before you start”- Register your app and connect a user.
- Call from your server or native app with
Authorization: Bearer ACCESS_TOKEN. Never send Mediux cookies. - Keep tokens out of logs, source control and web pages.
Each request checks the connection, the granted permission and that the user owns what you touch. You always act as the user who approved the token: an ID in the request never changes whose data you change.
Apps can’t publish or change artwork, Sets, Boxsets or Loadouts, delete Lists, Like anything or manage the account. Owners do those on mediux.io.
Responses are Cache-Control: private, no-store, and errors use the
shared error format. Send only the fields you change;
omitted fields stay as they are.
Routes
Section titled “Routes”| Area | Routes | Permission |
|---|---|---|
| Identity | GET /account | Any |
| Relationships | Follows and hides below | relationships:read or relationships:manage |
| Lists | /account/lists, see Read and edit Lists | lists:read or lists:write |
| Notifications | GET /notifications, POST /notifications/read | notifications:read |
Notifications
Section titled “Notifications”GET /notifications lists the user’s notifications, newest first, paged with
?after= and ?limit= (see protected lists).
POST /notifications/read marks them read: send { "ids": [...] } with 1 to 100
IDs, or { "all": true }. It answers { "data": { "markedRead": 3 } }. IDs that
aren’t the user’s change nothing.
All operations
Section titled “All operations”Relationships
| Method | Path | Operation | Scope |
|---|---|---|---|
| GET | /relationships | List relationships | relationships:read |
| PUT | /relationships/{username} | Follow or hide a User | relationships:manage |
| DELETE | /relationships/{username} | Clear a relationship | relationships:manage |
Identity
| Method | Path | Operation | Scope |
|---|---|---|---|
| GET | /account | Get the connected User | any App Permission |
Your Lists
| Method | Path | Operation | Scope |
|---|---|---|---|
| GET | /account/lists | List your Lists | lists:read |
| POST | /account/lists | Create a List | lists:write |
| GET | /account/lists/membership | Find your Lists holding a title | lists:read |
| GET | /account/lists/{id} | Get one of your Lists | lists:read |
| PATCH | /account/lists/{id} | Edit one of your Lists | lists:write |
| GET | /account/lists/{id}/titles/{family}/{entity} | Get a title in one of your Lists | lists:read |
| POST | /account/lists/{id}/titles | Add titles to a List | lists:write |
| POST | /account/lists/{id}/titles/remove | Remove titles from a List | lists:write |
| POST | /account/lists/{id}/assets | Add Assets to an Asset List | lists:write |
| POST | /account/lists/{id}/assets/remove | Remove Assets from an Asset List | lists:write |
| PUT | /account/lists/{id}/subscription | Subscribe to or leave a Public List | lists:write |
Notifications
| Method | Path | Operation | Scope |
|---|---|---|---|
| GET | /notifications | List your Notifications | notifications:read |
| POST | /notifications/read | Mark Notifications read | notifications:read |