Overview of Plecto API Endpoints

List of Plecto API Endpoints

Plecto allows you to access the following endpoints using either V2 or V3 base URL:

Base URL: https://app.plecto.com/api/v2/

V2 Endpoints, grouped by theme:

• /dashboards/

• /datasources/

• /registrations/

• /members/

• /teams/

  • /my-teams/

• /slideshows/

  • /screens/

  • /screen-devices/

  • /devices/

• /favorites/

• /formulas/

Base URL: https://app.plecto.com/api/v3/

V3 Endpoints:

• /achievement-types/

  • /achievement-type-icons/

• /posts/

Dashboards

• Endpoint: https://app.plecto.com/api/v2/dashboards/

• Methods: GET, POST

• Description: Retrieve or create dashboards in Plecto. GET returns details about existing dashboards, while POST creates a new dashboard.

• Example POST request above

Favorites

• Endpoint: https://app.plecto.com/api/v2/favorites/

• Methods: GET, POST

• Description: Retrieve dashboards marked as favorite or add new favorites. Favorite dashboards appear as shortcuts on the Home page in Plecto UI.

• Example POST request above

News feed posts

• Endpoint: https://app.plecto.com/api/v3/posts/

• Methods: GET

• Description: Read posts and send updates to your Plecto News Feed.

• Example POST request above

Devices

• Endpoint: https://app.plecto.com/api/v2/devices/

• Methods: GET, POST

• Description: Retrieve or create devices linked to the API user, such as an activated TV or mobile app where the user is logged in.

• Example POST request above

The username and password are needed to create a token that you will receive in the request response.

Teams

• Endpoint: https://app.plecto.com/api/v2/teams/

• Methods: GET, POST

• Description: Create or list teams within Plecto. Teams are used to group members and associate them with dashboards, data sources and other features.

• Example POST request above

Registrations

• Endpoint: https://app.plecto.com/api/v2/registrations/

• Methods: GET, POST, PUT, DELETE

• Description: Retrieve, update, or delete registrations associated with a data source.

• Usage information:

  • You can GET, PUT and DELETE a specific registration on the url /api/v2/registrations/<data_source>/<uuid>/

  • You can filter registration with the following query string parameters:

    • start_date (https://app.plecto.com/api/v2/registrations/?start\_date=2024-06-01T22:22:00)

    • end_date (https://app.plecto.com/api/v2/registrations/?end\_date=2024-06-01T22:22:00)

    • reference/external_id (https://app.plecto.com/api/v2/registrations/?reference=123)

    • data_source (https://app.plecto.com/api/v2/registrations/?data\_source=412c64d13fbf4c89bacd4224fb16a6db)

  • You can control pagination with the "page" parameter.

• Example POST request to /api/v2/registrations/ above

My teams

• Endpoint: https://app.plecto.com/api/v2/my-teams/

• Methods: GET

• Description: List the teams that the authenticated user is a member or manager of. Global Admins will still see all teams; all other users will only see their associated teams.

Screens

• Endpoint: https://app.plecto.com/api/v2/screens/

• Methods: GET

• Description: Get a list of slideshows. The details include the slideshow UUID, name, rotation, and organization UUID.

Members

• Endpoint: https://app.plecto.com/api/v2/members/

• Methods: GET, POST

• Description: Manage member data in the organization. Members will be listed on the Employees page in Plecto, and if sending data, they will be displayed in the relevant data sources.

• Usage information: Use GET to filter based on parameters like api_provider or api_id, and POST to add new members:

  • GET /api/v2/members/?api_provider=<your api_provider>&api_id=<your id>

• Example POST request above

Screen devices

• Endpoint: https://app.plecto.com/api/v2/screen-devices/

• Methods: GET

• Description: This endpoint returns a list of screens (TVs or computer screens) where your slideshows have been sent.

Themes

• Endpoint: https://app.plecto.com/api/v2/themes/

• Methods: GET, POST

• Description: Retrieve or create new themes that you can use on Plecto dashboards and contests.

• Example POST Request above

Slideshows

• Endpoint: https://app.plecto.com/api/v2/slideshows/

• Methods: GET, POST

• Description: Use this to manage your Plecto slideshows. You can create slideshows with various dashboard, contest, YouTube, and URL slides.

• Example POST request above

Achievements

• Endpoint: https://app.plecto.com/api/v3/achievement-types/

• Methods: GET, POST

• Description: Retrieve or create new achievements in Plecto. Choose between award, record, membership achievements. Read more about how achievements work here.

• Example POST Request above

Data sources

• Endpoint: https://app.plecto.com/api/v2/datasources/

• Methods: GET, POST

• Description: Access or create data sources, which serve as the foundation for managing data within Plecto.

• Example POST request above

teams vs. my-teams - What's the difference?

The difference between the /teams/ and /my-teams/ endpoints lies in the scope and details of the data they provide:

Scope of data:

• /teams/ retrieves all teams within the organization. It provides information about each team, including their id, uuid, members, managers, organization, and associated data sources.

• /my-teams/ returns only the teams that are directly associated with the authenticated user. These are typically the teams that the user is a member or manager of.

Response details:

• /teams/ provides a more comprehensive set of data for each team, such as id, organization, data_sources, home_dashboard, and home_screens. It uses numeric IDs for members and managers.

• /my-teams/ offers a simplified view of each team, omitting some fields like organization, home_dashboard, and data_sources. The response includes a picture field and uses UUIDs for members and managers instead of numeric IDs.

Use case differences:

• Use /teams/ when you need a full list of all teams in the organization or require detailed information about the teams.

• Use /my-teams/ to quickly fetch teams that the authenticated user is associated with, making it useful for personalized dashboards or user-specific functionality.

Formulas

• Endpoint: https://app.plecto.com/api/v2/formulas/

• Methods: GET, POST

• Description: Retrieve or create formulas. All formulas are universal and can be used across all Plecto features.

• Example POST request above

Achievement type icons

• Endpoint: https://app.plecto.com/api/v3/achievement-type-icons/

• Methods: GET

• Description: Retrieve the icons of your achievement badges. You'll get the image links in the response body.