DataSet API Collection
Number of APIs: 32
You can use the DataSet API to send and retrieve log data, archive events, and manage configuration files, users, and groups.
There are many ways to get data in. See our data model in the Getting Started guide. We also have a Java client library, and a command-line tool. If you want to talk directly to the servers in a language other than Java, this page is for you.
Authentication
Access to the DataSet API is via API keys. You must generate a key to access the API. There are four types: Log Read Access
, Log Write Access
, Configuration Read Access
, and Configuration Write Access
. The instructions for each method show which key is required.
Authentication can happen in two ways:
- Token the body of a POST request
{"token":"{token}"}
- Send the API key in a request by adding
Authorization: Bearer {token}
to the header
Response
The response always includes a status
property. If the request is a success the value is success
. Status values have slash-delimited components. For example, success/noSuchFile
shows that the request is a success, but the specified file does not exist. Both error/client
and error/server
are failed operations, but one is the client's fault, and the other is the server's.
-
Manage Groups - editGroupPermission POST {{app_url}}/api/editGroupPermissions
-
Query Data - query POST {{app_url}}/api/query
-
Query Data - powerQuery POST {{app_url}}/api/powerQuery
-
Manage Users - inviteUser POST {{app_url}}/api/inviteUser
-
Query Data - timeseriesQuery POST {{app_url}}/api/timeseriesQuery
-
Manage Files - getFile POST {{app_url}}/getFile
-
Query Data - facetQuery POST {{app_url}}/api/facetQuery
-
Archive Data - create log-archive-rules POST {{app_url}}/v2/api/log-archive-rules
-
Ingest Data - addEvents POST {{app_url}}/api/addEvents
-
Manage Users - revokeAccess POST {{app_url}}/api/revokeAccess