plexcsharp/docs/sdks/hubs/README.md

Hubs

(Hubs)

Overview

Hubs are a structured two-dimensional container for media, generally represented by multiple horizontal rows.

Available Operations

• GetGlobalHubs - Get Global Hubs
• GetRecentlyAdded - Get Recently Added
• GetLibraryHubs - Get library specific hubs

GetGlobalHubs

Get Global Hubs filtered by the parameters provided.

Example Usage

using LukeHagar.PlexAPI.SDK;
using LukeHagar.PlexAPI.SDK.Models.Components;

var sdk = new PlexAPI(accessToken: "<YOUR_API_KEY_HERE>");

var res = await sdk.Hubs.GetGlobalHubsAsync();

// handle response

Parameters

Parameter	Type	Required	Description
Count	double	➖	The number of items to return with each hub.
OnlyTransient	OnlyTransient	➖	Only return hubs which are "transient", meaning those which are prone to changing after media playback or addition (e.g. On Deck, or Recently Added).

Response

GetGlobalHubsResponse

Errors

Error Type	Status Code	Content Type
LukeHagar.PlexAPI.SDK.Models.Errors.GetGlobalHubsBadRequest	400	application/json
LukeHagar.PlexAPI.SDK.Models.Errors.GetGlobalHubsUnauthorized	401	application/json
LukeHagar.PlexAPI.SDK.Models.Errors.SDKException	4XX, 5XX	*/*

GetRecentlyAdded

This endpoint will return the recently added content.

Example Usage

using LukeHagar.PlexAPI.SDK;
using LukeHagar.PlexAPI.SDK.Models.Components;
using LukeHagar.PlexAPI.SDK.Models.Requests;

var sdk = new PlexAPI(accessToken: "<YOUR_API_KEY_HERE>");

GetRecentlyAddedRequest req = new GetRecentlyAddedRequest() {
    ContentDirectoryID = 39486,
    SectionID = 2,
    Type = LukeHagar.PlexAPI.SDK.Models.Requests.Type.TvShow,
    IncludeMeta = IncludeMeta.Enable,
};

var res = await sdk.Hubs.GetRecentlyAddedAsync(req);

// handle response

Parameters

Parameter	Type	Required	Description
request	GetRecentlyAddedRequest	✔️	The request object to use for the request.

Response

GetRecentlyAddedResponse

Errors

Error Type	Status Code	Content Type
LukeHagar.PlexAPI.SDK.Models.Errors.SDKException	4XX, 5XX	*/*

GetLibraryHubs

This endpoint will return a list of library specific hubs

Example Usage

using LukeHagar.PlexAPI.SDK;
using LukeHagar.PlexAPI.SDK.Models.Components;

var sdk = new PlexAPI(accessToken: "<YOUR_API_KEY_HERE>");

var res = await sdk.Hubs.GetLibraryHubsAsync(sectionId: 492.74D);

// handle response

Parameters

Parameter	Type	Required	Description
SectionId	double	✔️	the Id of the library to query
Count	double	➖	The number of items to return with each hub.
OnlyTransient	QueryParamOnlyTransient	➖	Only return hubs which are "transient", meaning those which are prone to changing after media playback or addition (e.g. On Deck, or Recently Added).

Response

GetLibraryHubsResponse

Errors

Error Type	Status Code	Content Type
LukeHagar.PlexAPI.SDK.Models.Errors.GetLibraryHubsBadRequest	400	application/json
LukeHagar.PlexAPI.SDK.Models.Errors.GetLibraryHubsUnauthorized	401	application/json
LukeHagar.PlexAPI.SDK.Models.Errors.SDKException	4XX, 5XX	*/*