The Tovuti API allows LMS administrators and software developers to create resilient and scalable integrations between Tovuti and other API-compatible applications. An integration with the Tovuti API allows any platform or application to share and receive data with Tovuti.
Endpoints are also referenced when configuring webhooks through Zapier.
This article outlines the following concepts:
- API Documentation
- Create a Tovuti API Token
- Review Each Endpoint
- Test Endpoints with Live Data
- Support
API Documentation
The Tovuti API Documentation is publicly available at api.tovuti.io. The API is written in alignment with the OpenAPI 3.0 specification, formerly known as the Swagger Specification. This means the documentation provides access to the raw schema.yml file, which contains all API data.
Each tag and endpoint is expandable to give full details on how to call each endpoint. Review the list of endpoints for an overview of what capabilities the Tovuti API provides.
Create a Tovuti API Token
A Tovuti API Token is a text string that encodes the LMS and provides authorized endpoints and methods to anyone using the token.
Review Each Endpoint
Click the expander for any category to view the specifications for all supported endpoints.
Open the /schema.yml file on the documentation page. The .yml shown is the formal OpenAPI specification of all endpoints and is used to create custom API code.
Endpoint Date Range Filtering
Each of the following endpoints can be date-filtered “before” or “after” by the following attributes:
- assignments:
- start_date
- end_date
- due_date
- created_on
- awards:
- created_on
- checklists:
- due_date
- created_on
- community groups:
- created
- courses:
- created_on
- modified_on
- course progress:
- date_started
- date_last_activity
- date_completed
- events:
- event_date
- event_end_date
- registration_start_date
- cut_off_date
- learningPaths:
- created_on
- modified_on
- learningPathCategories:
- created_on
- modified_on
- learningPathSubcategories:
- created_on
- modified_on
- lessons:
- created_on
- modified_on
- meetings:
- created
- date
- quizzes:
- created_on
- modified_on
- teams:
- date_created
- users:
- registeredate
- lastvisitdate
Test Endpoints with Live Data
To try out an endpoint, first, click Authorize.
Type “Bearer” followed by a space and paste the API Token into the space provided. Click Authorize.
Endpoints must be authorized by the Tovuti API Token to access the LMS and return data.
Expand an endpoint and click Try it out.
Enter the Parameters to include in the test, and click Execute.
The results of the endpoint test include the Curl Command (1), Authorization Token (2), Request URL (3), Server Response (4), and JSON response. Click Download (5) or Copy (6) to use the JSON response directly in the codebase, or in an API tool like Postman.
Support
For additional support, please contact Tovuti Support at support@tovutiteam.com or submit a request through the Tovuti Customer Portal.