โฑ๏ธ The Essentials in 3 Minutes |
๐ง Understand the Value of the Public API
A training platform never operates in isolation within an organization's information system - it communicates with the HRIS, ERP, CRM, and sometimes an employee portal. The Didask public API automates these exchanges so that training is fully integrated into your day-to-day operations.
In practice, this eliminates manual data entry (account creation, path assignment...), removes re-entry errors, and lets learning data flow where it is actually useful (HR dashboards, sales tracking, management reporting).
๐ Understand What the Didask Public API Is
The Didask public API is a digital gateway that allows external applications (HRIS, ERP, LMS, CRM...) to communicate automatically with Didask.
In simple terms, it lets you:
Create or update users in Didask from another tool.
Automatically assign learning paths to users.
Retrieve usage data (completion rates, time spent) to display in your internal dashboards.
This automation saves time, prevents manual errors, and integrates training into your existing tools without friction.
๐ฐ Understand the Pricing Model
๐ The API is included in your Didask license at no extra cost. You can start using it as soon as you are ready.
In return, you develop the connector yourself.
๐ก What is a connector? A connector is a small piece of software or script that acts as a bridge between two tools. It reads or writes data between your internal systems (e.g. HRIS) and Didask, via the API.
๐ If you would like Didask to design, deploy, and maintain this connector for you, contact your Key Account Manager to discuss a tailored engagement.
๐งญ Identify Typical Use Cases
Use case | Concrete example |
๐ Automatically create learner accounts from an HRIS or ERP | A new employee is added to your HR tool: the API automatically creates their Didask account. |
๐ค Push progress data to your systems | You use Salesforce to track skills development. Completion rates feed automatically into your HR dashboards. |
๐งฉ Embed Didask data in your internal applications | You have an employee portal: the API displays each user's Didask learning paths directly, without them needing to log in to Didask. |
๐งฎ Automate targeted training campaigns | A new employee joins your company: the API automatically triggers the assignment of the onboarding training. |
๐ ๏ธ Identify Available Features
Domain | Available actions |
๐ค User management | Create a new user - Update their information - Deactivate an account. |
๐ฏ Path and module management | Assign a publication to a group - Assign a group to a user - Invite a user by email to their space or a specific publication. |
๐ Usage data extraction | Retrieve completion status - Time spent - Last activity - Export group results. |
๐ Get Started: Generate Your API Key
โน๏ธ Creating an API key requires a platform administrator role.
How to generate an API key
Go to your platform settings under the API keys section.
Click Create an API key.
Choose the permissions (scopes) to assign to the key. They are grouped by area and can be set to read or write:
auth, groups, managers, publications, spaces, users
Click Create.
The key is displayed only once. Make sure to copy it and store it somewhere safe right away. If you lose it, you will need to create a new one, as Didask cannot show it again.
Good to know
Each key also has a fingerprint. This is a public ID that allows you to recognize the key in the list without revealing its actual content.
The API keys page lists all the workspace's keys: the creator's email address, the permissions (scopes), the creation date, and the last used date. Any platform admin can view and delete them, not just the person who created the key.
Keys apply to the entire workspace and cannot be restricted to a single space.
โ๏ธ Resolve Common Cases
Question | Answer |
Is the API free? | โ Yes, included in your license if you develop the connector. |
Do I need technical skills? | โ No to test. โ Yes for production (or get support). |
Can I test before going live? | โ Yes, a test environment is available on request. |
Can I stop using the API if I no longer need it? | โ Yes, you can revoke a key or stop the exchange at any time. |
Can Didask help me implement it? | โ Yes, speak to your Key Account Manager. |
๐ฉ Get Support from Didask
Our team is available to guide you on:
Retrieving your API key.
Initial testing in a dedicated environment.
Security best practices.
Developing a connector or connecting you with a partner integrator.
๐ Speak to your CSM or contact support via your Didask interface.
๐ก Technical Resources (Admins and Integrators)
Generic API documentation: ๐ https://didask.didask.com/api/v1
Platform-specific documentation:
yourplatformname.didask.com/api/v1(Replaceyourplatformnamewith your instance name.)
Keywords: public API, Didask API, connector, automation, HRIS, ERP, CRM, Salesforce, integration, API key, workflow, automatic onboarding.
