Understand your general resources
You'll need to know how to Get your access token before you can follow the instructions in this section.
Organizational structure
When you're set up within Certn, you belong to an organization. This organization has a few levels of hierarchy:
Superteams can have multiple Teams and Teams can have multiple Users. When you're added to Certn, you're linked to a Team, which is linked to a Superteam.
Authorization header
Replace
access_token
with your API access token:
Retrieve your Users
In the beginning, you'll be the only User in your organizational account. Let's retrieve your users by making a GET request to our /users/
endpoint.
In this example, we saved the results of the call to a new file named user_list.json
.
With everything set properly and a good internet connection, you should receive a response status of 200 OK
.
200 OK
{
[...]
"results": [
{
"id": "string<uuid>",
[...]
},
]
}
For more details on the structure of the User list response, see Retrieve a list of users.
Errors
Errors are a relatively common occurrence when working with APIs. It's always good to know how to prevent them and what to do when they arise.
See Error Codes for details on types of errors and how to resolve them.
Error codesLast updated