All currently available resources are listed in this documentation. If you have any suggestions for anything more you'd like to see in our API, please contact help@slemma.com - we will probably build them!

Endpoint path

Slemma API is hosted at https://slemma.com/api/v1.

HTTP Request Methods

The Slemma API uses the following request methods when accessing API resources: GET, POST, PUT and DELETE.
The GET method is used to retrieve (or read) a representation of a resource users, groups, and teams.
The POST method is used to update an existing resource.
The PUT method is used to create new resources.
The DELETE method is used to delete an existing resource.

Making API Requests

📘
Note
You have to be a team Admin or Owner to be able to make requests. Calls made by non-Admin users will fail (you'll get 403 Forbidden).

All API requests must be sent over HTTPS. Each request to Slemma's API endpoints must include the following HTTP headers:

Header Name	Description	Example
TeamID	Team ID	131219
SIG	Calculated as sha1(<Team Secret> + <User Token>)	a214bb15a05b1cde9a1e31d19d0660b18fb37394
Content-Type		application/json;charset=UTF-8

How to get your Team ID, Team Secret, User Token and SIG

Your Team ID, Team Secret and User Token are available on the API Keys page on Slemma, accessible from your Admin menu option. You will also see the generated SIG parameter. You can recreate Team Secret by clicking 'Generate new Team Secret' button. Your new Team Secret and new SIG parameter will then appear on the page.

❗️
Warning
User Token must be kept secret and transferred only over SSL, as it's effectively as good as a user's email and password.

Response Formats

Currently the only available response format is JSON and responses are type 'application/json'.

Response Codes

The following error messages descriptions are valid for any request and any object

Response codes	Response content	Description
401 Unauthorized	Incorrect teamid	Wrong teamid: please check your request and put in correct teamid parameter
401 Unauthorized	Incorrect sig	Wrong SIG: please check your request and put in correct SIG parameter
404 Not Found	End point not found	The requested endpoint was not found.
404 Not Found	No content	The requested URL was not found on this server.
405 Method Not Allowed	No content	This request method cannot be used: check the documentation for allowed methods.

Date Formats

All date values are returned in UTC.

Rate Limits

Records per request

Slemma supports up to 10000 records per request for append data to a Custom Dataset.

If you ever have any questions, or see anywhere we can improve our documentation, feel free to contact us by emailing help@slemma.com or use the 'Suggest edits' option which can be found on each page.