APIIntroduction
Changelog
1 September, 2022
- New trash bin endpoints
Authentication
We use a standard OAuth 2 authentication method.
You can generate an application key and a secret code from your settings page inside the Plutio app and use them to create a temporary access token.
YOUR_PLUTIO_SUBDOMAIN header value should be the first part of your Plutio domain. For example YOUR_PLUTIO_SUBDOMAIN value for https://test.plutio.com would be test.
Visit the "Getting Started" section for more information.
Error Codes
Code
Description
400
Bad request. The server cannot or will not process the request due to an apparent client error (malformed request syntax, invalid params)
401
Unauthorized. Access token is invalid or missing.
403
Forbidden. User is not allowed to perform the action, usually due to permission settings.
404
Not found. The requested resource could not be found.
405
Method not allowed. A request method is not supported for the requested resource; for example, a GET request on a form that requires data to be presented via POST
429
Too Many Requests. Your API limits have been reached.
500
Internal server error. Server could not process your request due to unexpected condition. Please try again later or if the issue persists please contact us.
Rate limit
There is a current limit of 1000 API calls an hour.
Paging
You can use skip and limit query parameters to get a different set of items.https://api.plutio.com/v1.8/tasks?skip=20&limit=50This will return tasks 21..70
Advanced queries (BETA)
You can use basic filters by supplying key-value pairs in GET request. For example to get a contact(s) with the first name of "leo", the get request URL would be https://api.plutio.com/v1.8/people?name.first=leo
In cases where advanced filters are required, a special query param q can be used to provide a raw MongoDB query. This allows you to build queries such as finding contact(s) who have the first name as "Leo" or the last name as "Doe". For example https://api.plutio.com/v1.8/people?q={"$or":[{"name.first": "John" }, { "name.last": "Doe" }]} (Value must be a valid JSON)
POST Create comment