plexgo/docs/sdks/sessions

Sessions

(Sessions)

Overview

API Calls that perform search operations with Plex Media Server Sessions

Available Operations

• GetSessions - Get Active Sessions
• GetSessionHistory - Get Session History
• GetTranscodeSessions - Get Transcode Sessions
• StopTranscodeSession - Stop a Transcode Session

GetSessions

This will retrieve the "Now Playing" Information of the PMS.

Example Usage

package main

import(
	"github.com/LukeHagar/plexgo"
	"context"
	"log"
)

func main() {
    s := plexgo.New(
        plexgo.WithSecurity("<YOUR_API_KEY_HERE>"),
        plexgo.WithXPlexClientIdentifier("Postman"),
    )

    ctx := context.Background()
    res, err := s.Sessions.GetSessions(ctx)
    if err != nil {
        log.Fatal(err)
    }
    if res.Object != nil {
        // handle response
    }
}

Parameters

Parameter	Type	Required	Description
ctx	context.Context	✔️	The context to use for the request.

Response

*operations.GetSessionsResponse, error

Error Object	Status Code	Content Type
sdkerrors.GetSessionsResponseBody	401	application/json
sdkerrors.SDKError	4xx-5xx	/

GetSessionHistory

This will Retrieve a listing of all history views.

Example Usage

package main

import(
	"github.com/LukeHagar/plexgo"
	"github.com/LukeHagar/plexgo/models/operations"
	"context"
	"log"
)

func main() {
    s := plexgo.New(
        plexgo.WithSecurity("<YOUR_API_KEY_HERE>"),
        plexgo.WithXPlexClientIdentifier("Postman"),
    )
    var sort *string = plexgo.String("<value>")

    var accountID *int64 = plexgo.Int64(1)

    var filter *operations.Filter = &operations.Filter{}

    var librarySectionID *int64 = plexgo.Int64(12)
    ctx := context.Background()
    res, err := s.Sessions.GetSessionHistory(ctx, sort, accountID, filter, librarySectionID)
    if err != nil {
        log.Fatal(err)
    }
    if res.Object != nil {
        // handle response
    }
}

Parameters

Parameter	Type	Required	Description	Example
ctx	context.Context	✔️	The context to use for the request.
sort	*string	➖	Sorts the results by the specified field followed by the direction (asc, desc)
accountID	*int64	➖	Filter results by those that are related to a specific users id	1
filter	*operations.Filter	➖	Filters content by field and direction/equality (Unknown if viewedAt is the only supported column)	{ "viewed-at-greater-than": { "value": "viewedAt\u003e" }, "viewed-at-greater-than-or-equal-to": { "value": "viewedAt\u003e=\u003e" }, "viewed-at-less-than": { "value": "viewedAt\u003c" } }
librarySectionID	*int64	➖	Filters the results based on the id of a valid library section	12

Response

*operations.GetSessionHistoryResponse, error

Error Object	Status Code	Content Type
sdkerrors.GetSessionHistoryResponseBody	401	application/json
sdkerrors.SDKError	4xx-5xx	/

GetTranscodeSessions

Get Transcode Sessions

Example Usage

package main

import(
	"github.com/LukeHagar/plexgo"
	"context"
	"log"
)

func main() {
    s := plexgo.New(
        plexgo.WithSecurity("<YOUR_API_KEY_HERE>"),
        plexgo.WithXPlexClientIdentifier("Postman"),
    )

    ctx := context.Background()
    res, err := s.Sessions.GetTranscodeSessions(ctx)
    if err != nil {
        log.Fatal(err)
    }
    if res.Object != nil {
        // handle response
    }
}

Parameters

Parameter	Type	Required	Description
ctx	context.Context	✔️	The context to use for the request.

Response

*operations.GetTranscodeSessionsResponse, error

Error Object	Status Code	Content Type
sdkerrors.GetTranscodeSessionsResponseBody	401	application/json
sdkerrors.SDKError	4xx-5xx	/

StopTranscodeSession

Stop a Transcode Session

Example Usage

package main

import(
	"github.com/LukeHagar/plexgo"
	"context"
	"log"
)

func main() {
    s := plexgo.New(
        plexgo.WithSecurity("<YOUR_API_KEY_HERE>"),
        plexgo.WithXPlexClientIdentifier("Postman"),
    )
    var sessionKey string = "zz7llzqlx8w9vnrsbnwhbmep"
    ctx := context.Background()
    res, err := s.Sessions.StopTranscodeSession(ctx, sessionKey)
    if err != nil {
        log.Fatal(err)
    }
    if res != nil {
        // handle response
    }
}

Parameters

Parameter	Type	Required	Description	Example
ctx	context.Context	✔️	The context to use for the request.
sessionKey	string	✔️	the Key of the transcode session to stop	zz7llzqlx8w9vnrsbnwhbmep

Response

*operations.StopTranscodeSessionResponse, error

Error Object	Status Code	Content Type
sdkerrors.StopTranscodeSessionResponseBody	401	application/json
sdkerrors.SDKError	4xx-5xx	/