losant_rest 1.8.7 → 1.8.9
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/docs/_schemas.md +38618 -21196
- data/docs/application.md +76 -0
- data/docs/auth.md +0 -36
- data/docs/dashboards.md +1 -1
- data/docs/dataTableRows.md +2 -2
- data/docs/device.md +1 -0
- data/docs/events.md +81 -0
- data/docs/file.md +43 -0
- data/docs/me.md +50 -13
- data/lib/losant_rest.rb +0 -4
- data/lib/losant_rest/application.rb +90 -0
- data/lib/losant_rest/application_api_token.rb +2 -0
- data/lib/losant_rest/application_api_tokens.rb +2 -0
- data/lib/losant_rest/application_certificate.rb +2 -0
- data/lib/losant_rest/application_certificate_authorities.rb +2 -0
- data/lib/losant_rest/application_certificate_authority.rb +2 -0
- data/lib/losant_rest/application_certificates.rb +2 -0
- data/lib/losant_rest/application_key.rb +2 -0
- data/lib/losant_rest/application_keys.rb +2 -0
- data/lib/losant_rest/applications.rb +2 -0
- data/lib/losant_rest/audit_log.rb +2 -0
- data/lib/losant_rest/audit_logs.rb +2 -0
- data/lib/losant_rest/auth.rb +2 -42
- data/lib/losant_rest/client.rb +2 -18
- data/lib/losant_rest/dashboard.rb +2 -0
- data/lib/losant_rest/dashboards.rb +3 -1
- data/lib/losant_rest/data.rb +2 -0
- data/lib/losant_rest/data_table.rb +2 -0
- data/lib/losant_rest/data_table_row.rb +2 -0
- data/lib/losant_rest/data_table_rows.rb +4 -2
- data/lib/losant_rest/data_tables.rb +2 -0
- data/lib/losant_rest/device.rb +4 -0
- data/lib/losant_rest/device_recipe.rb +2 -0
- data/lib/losant_rest/device_recipes.rb +2 -0
- data/lib/losant_rest/devices.rb +2 -0
- data/lib/losant_rest/edge_deployments.rb +2 -0
- data/lib/losant_rest/event.rb +2 -0
- data/lib/losant_rest/events.rb +103 -0
- data/lib/losant_rest/experience.rb +2 -0
- data/lib/losant_rest/experience_domain.rb +2 -0
- data/lib/losant_rest/experience_domains.rb +2 -0
- data/lib/losant_rest/experience_endpoint.rb +2 -0
- data/lib/losant_rest/experience_endpoints.rb +2 -0
- data/lib/losant_rest/experience_group.rb +2 -0
- data/lib/losant_rest/experience_groups.rb +2 -0
- data/lib/losant_rest/experience_slug.rb +2 -0
- data/lib/losant_rest/experience_slugs.rb +2 -0
- data/lib/losant_rest/experience_user.rb +2 -0
- data/lib/losant_rest/experience_users.rb +2 -0
- data/lib/losant_rest/experience_version.rb +2 -0
- data/lib/losant_rest/experience_versions.rb +2 -0
- data/lib/losant_rest/experience_view.rb +2 -0
- data/lib/losant_rest/experience_views.rb +2 -0
- data/lib/losant_rest/file.rb +2 -0
- data/lib/losant_rest/files.rb +2 -0
- data/lib/losant_rest/flow.rb +2 -0
- data/lib/losant_rest/flow_version.rb +2 -0
- data/lib/losant_rest/flow_versions.rb +2 -0
- data/lib/losant_rest/flows.rb +2 -0
- data/lib/losant_rest/integration.rb +2 -0
- data/lib/losant_rest/integrations.rb +2 -0
- data/lib/losant_rest/me.rb +57 -13
- data/lib/losant_rest/notebook.rb +2 -0
- data/lib/losant_rest/notebooks.rb +2 -0
- data/lib/losant_rest/org.rb +2 -0
- data/lib/losant_rest/org_invites.rb +2 -0
- data/lib/losant_rest/orgs.rb +2 -0
- data/lib/losant_rest/version.rb +1 -1
- data/lib/losant_rest/webhook.rb +2 -0
- data/lib/losant_rest/webhooks.rb +2 -0
- data/schemas/advancedEventQuery.json +817 -0
- data/schemas/{dataTableQuery.json → advancedQuery.json} +5 -4
- data/schemas/apiTokens.json +4 -1
- data/schemas/application.json +30 -1
- data/schemas/applicationApiTokenPost.json +5 -0
- data/schemas/applicationCertificate.json +29 -1
- data/schemas/applicationCertificateAuthorities.json +36 -3
- data/schemas/applicationCertificateAuthority.json +32 -2
- data/schemas/applicationCertificateAuthorityPatch.json +3 -1
- data/schemas/applicationCertificateAuthorityPost.json +3 -1
- data/schemas/applicationCertificatePatch.json +3 -1
- data/schemas/applicationCertificatePost.json +3 -1
- data/schemas/applicationCertificates.json +33 -2
- data/schemas/applicationKeys.json +4 -1
- data/schemas/applicationPatch.json +28 -0
- data/schemas/applicationPost.json +28 -0
- data/schemas/applications.json +34 -2
- data/schemas/auditLog.json +0 -3
- data/schemas/auditLogFilter.json +0 -3
- data/schemas/auditLogs.json +4 -4
- data/schemas/authedDevice.json +7 -0
- data/schemas/dashboard.json +3970 -72
- data/schemas/dashboardPatch.json +3969 -72
- data/schemas/dashboardPost.json +3969 -72
- data/schemas/dashboardSendReport.json +4 -0
- data/schemas/dashboardUpdateEvents.json +46 -0
- data/schemas/dashboards.json +3974 -73
- data/schemas/dataTableRows.json +4 -1
- data/schemas/dataTableRowsExport.json +11 -7
- data/schemas/dataTables.json +4 -1
- data/schemas/deviceRecipes.json +4 -1
- data/schemas/devices.json +4 -1
- data/schemas/event.json +19 -2
- data/schemas/eventPost.json +0 -1
- data/schemas/eventTagsSummary.json +28 -0
- data/schemas/events.json +841 -3
- data/schemas/eventsDeleted.json +9 -0
- data/schemas/eventsExport.json +830 -0
- data/schemas/experienceDomain.json +6 -2
- data/schemas/experienceDomainPatch.json +14 -10
- data/schemas/experienceDomainPost.json +8 -4
- data/schemas/experienceDomains.json +6 -2
- data/schemas/experienceEndpoints.json +4 -1
- data/schemas/experienceGroup.json +2 -2
- data/schemas/experienceGroupPatch.json +2 -2
- data/schemas/experienceGroupPost.json +2 -2
- data/schemas/experienceGroups.json +6 -3
- data/schemas/experienceSlugPatch.json +2 -2
- data/schemas/experienceSlugPost.json +2 -2
- data/schemas/experienceUsers.json +4 -1
- data/schemas/experienceViews.json +4 -1
- data/schemas/files.json +4 -1
- data/schemas/flow.json +4 -0
- data/schemas/flowPatch.json +6 -2
- data/schemas/flowPost.json +4 -0
- data/schemas/flowVersion.json +8 -0
- data/schemas/flowVersionPost.json +4 -0
- data/schemas/flowVersions.json +12 -1
- data/schemas/flows.json +8 -1
- data/schemas/flowsImportPost.json +10 -2
- data/schemas/flowsImportResult.json +12 -0
- data/schemas/githubLogin.json +6 -15
- data/schemas/integrations.json +4 -1
- data/schemas/notebooks.json +4 -1
- data/schemas/org.json +2 -4
- data/schemas/orgPatch.json +2 -1
- data/schemas/orgPost.json +2 -1
- data/schemas/orgs.json +6 -5
- data/schemas/passwordResetFinish.json +0 -4
- data/schemas/passwordResetInput.json +0 -4
- data/schemas/resourceTransfer.json +0 -8
- data/schemas/userCredentials.json +6 -15
- data/schemas/userPost.json +6 -15
- data/schemas/webhooks.json +4 -1
- data/test/basic_test.rb +15 -0
- metadata +8 -23
- data/docs/solution.md +0 -133
- data/docs/solutionUser.md +0 -139
- data/docs/solutionUsers.md +0 -96
- data/docs/solutions.md +0 -91
- data/lib/losant_rest/solution.rb +0 -174
- data/lib/losant_rest/solution_user.rb +0 -180
- data/lib/losant_rest/solution_users.rb +0 -138
- data/lib/losant_rest/solutions.rb +0 -134
- data/schemas/authedSolutionUser.json +0 -18
- data/schemas/fileUploadPostResp.json +0 -109
- data/schemas/solution.json +0 -76
- data/schemas/solutionMe.json +0 -150
- data/schemas/solutionPatch.json +0 -48
- data/schemas/solutionPost.json +0 -52
- data/schemas/solutionUser.json +0 -103
- data/schemas/solutionUserCredentials.json +0 -34
- data/schemas/solutionUserPatch.json +0 -74
- data/schemas/solutionUserPost.json +0 -80
- data/schemas/solutionUsers.json +0 -149
- data/schemas/solutions.json +0 -118
data/docs/application.md
CHANGED
@@ -9,6 +9,8 @@ parameters and the potential responses.
|
|
9
9
|
* [Archive Data](#archive-data)
|
10
10
|
* [Backfill Archive Data](#backfill-archive-data)
|
11
11
|
* [Delete](#delete)
|
12
|
+
* [Full Data Tables Archive](#full-data-tables-archive)
|
13
|
+
* [Full Events Archive](#full-events-archive)
|
12
14
|
* [Get](#get)
|
13
15
|
* [Mqtt Publish Message](#mqtt-publish-message)
|
14
16
|
* [Patch](#patch)
|
@@ -131,6 +133,80 @@ all.Application, all.Organization, all.User, application.*, or application.delet
|
|
131
133
|
|
132
134
|
<br/>
|
133
135
|
|
136
|
+
## Full Data Tables Archive
|
137
|
+
|
138
|
+
Returns success when a job has been enqueued to archive all selected data tables
|
139
|
+
|
140
|
+
```ruby
|
141
|
+
result = client.application.full_data_tables_archive(applicationId: my_application_id)
|
142
|
+
|
143
|
+
puts result
|
144
|
+
```
|
145
|
+
|
146
|
+
#### Authentication
|
147
|
+
The client must be configured with a valid api access token to call this
|
148
|
+
action. The token must include at least one of the following scopes:
|
149
|
+
all.Application, all.Organization, all.User, application.*, or application.fullDataTablesArchive.
|
150
|
+
|
151
|
+
#### Available Parameters
|
152
|
+
|
153
|
+
| Name | Type | Required | Description | Default | Example |
|
154
|
+
| ---- | ---- | -------- | ----------- | ------- | ------- |
|
155
|
+
| applicationId | string | Y | ID of the associated application | | 575ec8687ae143cd83dc4a97 |
|
156
|
+
| losantdomain | string | N | Domain scope of request (rarely needed) | | example.com |
|
157
|
+
|
158
|
+
#### Successful Responses
|
159
|
+
|
160
|
+
| Code | Type | Description |
|
161
|
+
| ---- | ---- | ----------- |
|
162
|
+
| 200 | [Success](_schemas.md#success) | Enqueued a job to archive all selected data tables of this application archive location |
|
163
|
+
|
164
|
+
#### Error Responses
|
165
|
+
|
166
|
+
| Code | Type | Description |
|
167
|
+
| ---- | ---- | ----------- |
|
168
|
+
| 400 | [Error](_schemas.md#error) | Error if malformed request |
|
169
|
+
| 404 | [Error](_schemas.md#error) | Error if application was not found |
|
170
|
+
|
171
|
+
<br/>
|
172
|
+
|
173
|
+
## Full Events Archive
|
174
|
+
|
175
|
+
Returns success when a job has been enqueued to archive all current events
|
176
|
+
|
177
|
+
```ruby
|
178
|
+
result = client.application.full_events_archive(applicationId: my_application_id)
|
179
|
+
|
180
|
+
puts result
|
181
|
+
```
|
182
|
+
|
183
|
+
#### Authentication
|
184
|
+
The client must be configured with a valid api access token to call this
|
185
|
+
action. The token must include at least one of the following scopes:
|
186
|
+
all.Application, all.Organization, all.User, application.*, or application.fullEventsArchive.
|
187
|
+
|
188
|
+
#### Available Parameters
|
189
|
+
|
190
|
+
| Name | Type | Required | Description | Default | Example |
|
191
|
+
| ---- | ---- | -------- | ----------- | ------- | ------- |
|
192
|
+
| applicationId | string | Y | ID of the associated application | | 575ec8687ae143cd83dc4a97 |
|
193
|
+
| losantdomain | string | N | Domain scope of request (rarely needed) | | example.com |
|
194
|
+
|
195
|
+
#### Successful Responses
|
196
|
+
|
197
|
+
| Code | Type | Description |
|
198
|
+
| ---- | ---- | ----------- |
|
199
|
+
| 200 | [Success](_schemas.md#success) | Enqueued a job to archive all events to this application archive location |
|
200
|
+
|
201
|
+
#### Error Responses
|
202
|
+
|
203
|
+
| Code | Type | Description |
|
204
|
+
| ---- | ---- | ----------- |
|
205
|
+
| 400 | [Error](_schemas.md#error) | Error if malformed request |
|
206
|
+
| 404 | [Error](_schemas.md#error) | Error if application was not found |
|
207
|
+
|
208
|
+
<br/>
|
209
|
+
|
134
210
|
## Get
|
135
211
|
|
136
212
|
Retrieves information on an application
|
data/docs/auth.md
CHANGED
@@ -7,7 +7,6 @@ parameters and the potential responses.
|
|
7
7
|
##### Contents
|
8
8
|
|
9
9
|
* [Authenticate Device](#authenticate-device)
|
10
|
-
* [Authenticate Solution User](#authenticate-solution-user)
|
11
10
|
* [Authenticate User](#authenticate-user)
|
12
11
|
* [Authenticate User Github](#authenticate-user-github)
|
13
12
|
|
@@ -48,41 +47,6 @@ No api access token is required to call this action.
|
|
48
47
|
|
49
48
|
<br/>
|
50
49
|
|
51
|
-
## Authenticate Solution User
|
52
|
-
|
53
|
-
Authenticates a solution user using the provided credentials.
|
54
|
-
|
55
|
-
```ruby
|
56
|
-
result = client.auth.authenticate_solution_user(credentials: my_credentials)
|
57
|
-
|
58
|
-
puts result
|
59
|
-
```
|
60
|
-
|
61
|
-
#### Authentication
|
62
|
-
No api access token is required to call this action.
|
63
|
-
|
64
|
-
#### Available Parameters
|
65
|
-
|
66
|
-
| Name | Type | Required | Description | Default | Example |
|
67
|
-
| ---- | ---- | -------- | ----------- | ------- | ------- |
|
68
|
-
| credentials | [Solution User Credentials](_schemas.md#solution-user-credentials) | Y | Solution user authentication credentials. The included api access token has the scope 'all.SolutionUser'. | | [Solution User Credentials Example](_schemas.md#solution-user-credentials-example) |
|
69
|
-
| losantdomain | string | N | Domain scope of request (rarely needed) | | example.com |
|
70
|
-
|
71
|
-
#### Successful Responses
|
72
|
-
|
73
|
-
| Code | Type | Description |
|
74
|
-
| ---- | ---- | ----------- |
|
75
|
-
| 200 | [Authenticated Solution User](_schemas.md#authenticated-solution-user) | Successful authentication |
|
76
|
-
|
77
|
-
#### Error Responses
|
78
|
-
|
79
|
-
| Code | Type | Description |
|
80
|
-
| ---- | ---- | ----------- |
|
81
|
-
| 400 | [Error](_schemas.md#error) | Error if malformed request |
|
82
|
-
| 401 | [Error](_schemas.md#error) | Unauthorized error if authentication fails |
|
83
|
-
|
84
|
-
<br/>
|
85
|
-
|
86
50
|
## Authenticate User
|
87
51
|
|
88
52
|
Authenticates a user using the provided credentials.
|
data/docs/dashboards.md
CHANGED
@@ -24,7 +24,7 @@ puts result
|
|
24
24
|
#### Authentication
|
25
25
|
The client must be configured with a valid api access token to call this
|
26
26
|
action. The token must include at least one of the following scopes:
|
27
|
-
all.Organization, all.Organization.read, all.
|
27
|
+
all.Organization, all.Organization.read, all.User, all.User.read, dashboards.*, or dashboards.get.
|
28
28
|
|
29
29
|
#### Available Parameters
|
30
30
|
|
data/docs/dataTableRows.md
CHANGED
@@ -38,7 +38,7 @@ all.Application, all.Organization, all.User, dataTableRows.*, or dataTableRows.d
|
|
38
38
|
| ---- | ---- | -------- | ----------- | ------- | ------- |
|
39
39
|
| applicationId | string | Y | ID associated with the application | | 575ec8687ae143cd83dc4a97 |
|
40
40
|
| dataTableId | string | Y | ID associated with the data table | | 575ed78e7ae143cd83dc4aab |
|
41
|
-
| query | [
|
41
|
+
| query | [Advanced Query](_schemas.md#advanced-query) | N | Query to apply to filter the data table | | [Advanced Query Example](_schemas.md#advanced-query-example) |
|
42
42
|
| limit | string | N | Limit number of rows to delete from data table | 1000 | 10 |
|
43
43
|
| losantdomain | string | N | Domain scope of request (rarely needed) | | example.com |
|
44
44
|
|
@@ -214,7 +214,7 @@ all.Application, all.Application.read, all.Organization, all.Organization.read,
|
|
214
214
|
| limit | string | N | How many rows to return | 1000 | 0 |
|
215
215
|
| offset | string | N | How many rows to skip | 0 | 0 |
|
216
216
|
| includeFields | string | N | Comma-separated list of fields to include in resulting rows. When not provided, returns all fields. | | id,createdAt |
|
217
|
-
| query | [
|
217
|
+
| query | [Advanced Query](_schemas.md#advanced-query) | N | Query to apply to filter the data table | | [Advanced Query Example](_schemas.md#advanced-query-example) |
|
218
218
|
| losantdomain | string | N | Domain scope of request (rarely needed) | | example.com |
|
219
219
|
|
220
220
|
#### Successful Responses
|
data/docs/device.md
CHANGED
@@ -213,6 +213,7 @@ all.Application, all.Application.read, all.Device, all.Device.read, all.Organiza
|
|
213
213
|
| deviceId | string | Y | ID associated with the device | | 575ecf887ae143cd83dc4aa2 |
|
214
214
|
| start | string | N | Start of time range to look at to build composite state | 1 | 1465790400000 |
|
215
215
|
| end | string | N | End of time range to look at to build composite state | 0 | 1465790400000 |
|
216
|
+
| attributes | string | N | Comma-separated list of attributes to include. When not provided, returns all attributes. | | myAttr1,myAttr2 |
|
216
217
|
| losantdomain | string | N | Domain scope of request (rarely needed) | | example.com |
|
217
218
|
|
218
219
|
#### Successful Responses
|
data/docs/events.md
CHANGED
@@ -6,6 +6,8 @@ parameters and the potential responses.
|
|
6
6
|
|
7
7
|
##### Contents
|
8
8
|
|
9
|
+
* [Delete](#delete)
|
10
|
+
* [Export](#export)
|
9
11
|
* [Get](#get)
|
10
12
|
* [Most Recent by Severity](#most-recent-by-severity)
|
11
13
|
* [Patch](#patch)
|
@@ -13,6 +15,82 @@ parameters and the potential responses.
|
|
13
15
|
|
14
16
|
<br/>
|
15
17
|
|
18
|
+
## Delete
|
19
|
+
|
20
|
+
Delete events
|
21
|
+
|
22
|
+
```ruby
|
23
|
+
result = client.events.delete(applicationId: my_application_id)
|
24
|
+
|
25
|
+
puts result
|
26
|
+
```
|
27
|
+
|
28
|
+
#### Authentication
|
29
|
+
The client must be configured with a valid api access token to call this
|
30
|
+
action. The token must include at least one of the following scopes:
|
31
|
+
all.Application, all.Application.read, all.Organization, all.Organization.read, all.User, all.User.read, events.*, or events.delete.
|
32
|
+
|
33
|
+
#### Available Parameters
|
34
|
+
|
35
|
+
| Name | Type | Required | Description | Default | Example |
|
36
|
+
| ---- | ---- | -------- | ----------- | ------- | ------- |
|
37
|
+
| applicationId | string | Y | ID associated with the application | | 575ec8687ae143cd83dc4a97 |
|
38
|
+
| query | [Advanced Event Query](_schemas.md#advanced-event-query) | N | Query to apply to filter the events | | [Advanced Event Query Example](_schemas.md#advanced-event-query-example) |
|
39
|
+
| losantdomain | string | N | Domain scope of request (rarely needed) | | example.com |
|
40
|
+
|
41
|
+
#### Successful Responses
|
42
|
+
|
43
|
+
| Code | Type | Description |
|
44
|
+
| ---- | ---- | ----------- |
|
45
|
+
| 200 | [Events Deleted](_schemas.md#events-deleted) | If request successfully deletes a set of Events |
|
46
|
+
|
47
|
+
#### Error Responses
|
48
|
+
|
49
|
+
| Code | Type | Description |
|
50
|
+
| ---- | ---- | ----------- |
|
51
|
+
| 400 | [Error](_schemas.md#error) | Error if malformed request |
|
52
|
+
| 404 | [Error](_schemas.md#error) | Error if events were not found |
|
53
|
+
|
54
|
+
<br/>
|
55
|
+
|
56
|
+
## Export
|
57
|
+
|
58
|
+
Request an export of an application's event data
|
59
|
+
|
60
|
+
```ruby
|
61
|
+
result = client.events.export(applicationId: my_application_id)
|
62
|
+
|
63
|
+
puts result
|
64
|
+
```
|
65
|
+
|
66
|
+
#### Authentication
|
67
|
+
The client must be configured with a valid api access token to call this
|
68
|
+
action. The token must include at least one of the following scopes:
|
69
|
+
all.Application, all.Application.read, all.Organization, all.Organization.read, all.User, all.User.read, events.*, or events.export.
|
70
|
+
|
71
|
+
#### Available Parameters
|
72
|
+
|
73
|
+
| Name | Type | Required | Description | Default | Example |
|
74
|
+
| ---- | ---- | -------- | ----------- | ------- | ------- |
|
75
|
+
| applicationId | string | Y | ID associated with the application | | 575ec8687ae143cd83dc4a97 |
|
76
|
+
| exportData | [Event Export Options](_schemas.md#event-export-options) | N | Export options for events | | [Event Export Options Example](_schemas.md#event-export-options-example) |
|
77
|
+
| losantdomain | string | N | Domain scope of request (rarely needed) | | example.com |
|
78
|
+
|
79
|
+
#### Successful Responses
|
80
|
+
|
81
|
+
| Code | Type | Description |
|
82
|
+
| ---- | ---- | ----------- |
|
83
|
+
| 200 | [Success](_schemas.md#success) | If generation of export was successfully started |
|
84
|
+
|
85
|
+
#### Error Responses
|
86
|
+
|
87
|
+
| Code | Type | Description |
|
88
|
+
| ---- | ---- | ----------- |
|
89
|
+
| 400 | [Error](_schemas.md#error) | Error if malformed request |
|
90
|
+
| 404 | [Error](_schemas.md#error) | Error if application was not found |
|
91
|
+
|
92
|
+
<br/>
|
93
|
+
|
16
94
|
## Get
|
17
95
|
|
18
96
|
Returns the events for an application
|
@@ -40,6 +118,7 @@ all.Application, all.Application.read, all.Organization, all.Organization.read,
|
|
40
118
|
| filterField | string | N | Field to filter the results by. Blank or not provided means no filtering. Accepted values are: subject | | subject |
|
41
119
|
| filter | string | N | Filter to apply against the filtered field. Supports globbing. Blank or not provided means no filtering. | | abnormal power to * |
|
42
120
|
| state | string | N | If provided, return events only in the given state. Accepted values are: new, acknowledged, resolved | | new |
|
121
|
+
| query | [Advanced Event Query](_schemas.md#advanced-event-query) | N | Event filter JSON object which overides the filterField, filter, and state parameters. | | [Advanced Event Query Example](_schemas.md#advanced-event-query-example) |
|
43
122
|
| losantdomain | string | N | Domain scope of request (rarely needed) | | example.com |
|
44
123
|
|
45
124
|
#### Successful Responses
|
@@ -78,6 +157,7 @@ all.Application, all.Application.read, all.Organization, all.Organization.read,
|
|
78
157
|
| ---- | ---- | -------- | ----------- | ------- | ------- |
|
79
158
|
| applicationId | string | Y | ID associated with the application | | 575ec8687ae143cd83dc4a97 |
|
80
159
|
| filter | string | N | Filter to apply against event subjects. Supports globbing. Blank or not provided means no filtering. | | abnormal power to * |
|
160
|
+
| query | [Advanced Event Query](_schemas.md#advanced-event-query) | N | Event filter JSON object which overides the filter parameter. | | [Advanced Event Query Example](_schemas.md#advanced-event-query-example) |
|
81
161
|
| losantdomain | string | N | Domain scope of request (rarely needed) | | example.com |
|
82
162
|
|
83
163
|
#### Successful Responses
|
@@ -119,6 +199,7 @@ all.Application, all.Organization, all.User, events.*, or events.patch.
|
|
119
199
|
| filterField | string | N | Field to filter the events to act on by. Blank or not provided means no filtering. Accepted values are: subject | | subject |
|
120
200
|
| filter | string | N | Filter to apply against the filtered field. Supports globbing. Blank or not provided means no filtering. | | abnormal power to * |
|
121
201
|
| state | string | N | If provided, act on events only in the given state. Accepted values are: new, acknowledged, resolved | | new |
|
202
|
+
| query | [Advanced Event Query](_schemas.md#advanced-event-query) | N | Event filter JSON object which overides the filterField, filter, and state parameters. | | [Advanced Event Query Example](_schemas.md#advanced-event-query-example) |
|
122
203
|
| updates | [Event Patch](_schemas.md#event-patch) | Y | Object containing updated information for the events | | [Event Patch Example](_schemas.md#event-patch-example) |
|
123
204
|
| losantdomain | string | N | Domain scope of request (rarely needed) | | example.com |
|
124
205
|
|
data/docs/file.md
CHANGED
@@ -10,6 +10,7 @@ parameters and the potential responses.
|
|
10
10
|
* [Get](#get)
|
11
11
|
* [Move](#move)
|
12
12
|
* [Patch](#patch)
|
13
|
+
* [Upload](#upload)
|
13
14
|
|
14
15
|
<br/>
|
15
16
|
|
@@ -174,3 +175,45 @@ all.Application, all.Organization, all.User, file.*, or file.patch.
|
|
174
175
|
| ---- | ---- | ----------- |
|
175
176
|
| 400 | [Error](_schemas.md#error) | Error if malformed request |
|
176
177
|
| 404 | [Error](_schemas.md#error) | Error if application was not found |
|
178
|
+
|
179
|
+
<br/>
|
180
|
+
|
181
|
+
## Upload
|
182
|
+
|
183
|
+
Uploads the file
|
184
|
+
|
185
|
+
```ruby
|
186
|
+
result = client.file.upload(
|
187
|
+
applicationId: my_application_id,
|
188
|
+
fileId: my_file_id,
|
189
|
+
file: my_file)
|
190
|
+
|
191
|
+
puts result
|
192
|
+
```
|
193
|
+
|
194
|
+
#### Authentication
|
195
|
+
The client must be configured with a valid api access token to call this
|
196
|
+
action. The token must include at least one of the following scopes:
|
197
|
+
all.Application, all.Organization, all.User, file.*, or file.upload.
|
198
|
+
|
199
|
+
#### Available Parameters
|
200
|
+
|
201
|
+
| Name | Type | Required | Description | Default | Example |
|
202
|
+
| ---- | ---- | -------- | ----------- | ------- | ------- |
|
203
|
+
| applicationId | string | Y | ID associated with the application | | 575ec8687ae143cd83dc4a97 |
|
204
|
+
| fileId | string | Y | ID associated with the file | | 575ec76c7ae143cd83dc4a96 |
|
205
|
+
| file | file | Y | The content of the file to upload | | undefined |
|
206
|
+
| losantdomain | string | N | Domain scope of request (rarely needed) | | example.com |
|
207
|
+
|
208
|
+
#### Successful Responses
|
209
|
+
|
210
|
+
| Code | Type | Description |
|
211
|
+
| ---- | ---- | ----------- |
|
212
|
+
| 200 | [File Schema](_schemas.md#file-schema) | Updated file content |
|
213
|
+
|
214
|
+
#### Error Responses
|
215
|
+
|
216
|
+
| Code | Type | Description |
|
217
|
+
| ---- | ---- | ----------- |
|
218
|
+
| 400 | [Error](_schemas.md#error) | Error if malformed request |
|
219
|
+
| 404 | [Error](_schemas.md#error) | Error if application was not found |
|
data/docs/me.md
CHANGED
@@ -17,6 +17,7 @@ parameters and the potential responses.
|
|
17
17
|
* [Get](#get)
|
18
18
|
* [Patch](#patch)
|
19
19
|
* [Payload Counts](#payload-counts)
|
20
|
+
* [Refresh Token](#refresh-token)
|
20
21
|
* [Transfer Resources](#transfer-resources)
|
21
22
|
* [Verify Email](#verify-email)
|
22
23
|
|
@@ -35,7 +36,7 @@ puts result
|
|
35
36
|
#### Authentication
|
36
37
|
The client must be configured with a valid api access token to call this
|
37
38
|
action. The token must include at least one of the following scopes:
|
38
|
-
all.
|
39
|
+
all.User, me.*, or me.addRecentItem.
|
39
40
|
|
40
41
|
#### Available Parameters
|
41
42
|
|
@@ -71,7 +72,7 @@ puts result
|
|
71
72
|
#### Authentication
|
72
73
|
The client must be configured with a valid api access token to call this
|
73
74
|
action. The token must include at least one of the following scopes:
|
74
|
-
all.
|
75
|
+
all.User, me.*, or me.changePassword.
|
75
76
|
|
76
77
|
#### Available Parameters
|
77
78
|
|
@@ -107,7 +108,7 @@ puts result
|
|
107
108
|
#### Authentication
|
108
109
|
The client must be configured with a valid api access token to call this
|
109
110
|
action. The token must include at least one of the following scopes:
|
110
|
-
all.
|
111
|
+
all.User, me.*, or me.delete.
|
111
112
|
|
112
113
|
#### Available Parameters
|
113
114
|
|
@@ -143,7 +144,7 @@ puts result
|
|
143
144
|
#### Authentication
|
144
145
|
The client must be configured with a valid api access token to call this
|
145
146
|
action. The token must include at least one of the following scopes:
|
146
|
-
all.
|
147
|
+
all.User, me.*, or me.disableTwoFactorAuth.
|
147
148
|
|
148
149
|
#### Available Parameters
|
149
150
|
|
@@ -179,7 +180,7 @@ puts result
|
|
179
180
|
#### Authentication
|
180
181
|
The client must be configured with a valid api access token to call this
|
181
182
|
action. The token must include at least one of the following scopes:
|
182
|
-
all.
|
183
|
+
all.User, me.*, or me.disconnectGithub.
|
183
184
|
|
184
185
|
#### Available Parameters
|
185
186
|
|
@@ -214,7 +215,7 @@ puts result
|
|
214
215
|
#### Authentication
|
215
216
|
The client must be configured with a valid api access token to call this
|
216
217
|
action. The token must include at least one of the following scopes:
|
217
|
-
all.
|
218
|
+
all.User, me.*, or me.disconnectTwitter.
|
218
219
|
|
219
220
|
#### Available Parameters
|
220
221
|
|
@@ -249,7 +250,7 @@ puts result
|
|
249
250
|
#### Authentication
|
250
251
|
The client must be configured with a valid api access token to call this
|
251
252
|
action. The token must include at least one of the following scopes:
|
252
|
-
all.
|
253
|
+
all.User, me.*, or me.enableTwoFactorAuth.
|
253
254
|
|
254
255
|
#### Available Parameters
|
255
256
|
|
@@ -285,7 +286,7 @@ puts result
|
|
285
286
|
#### Authentication
|
286
287
|
The client must be configured with a valid api access token to call this
|
287
288
|
action. The token must include at least one of the following scopes:
|
288
|
-
all.
|
289
|
+
all.User, all.User.read, me.*, or me.fetchRecentItems.
|
289
290
|
|
290
291
|
#### Available Parameters
|
291
292
|
|
@@ -322,7 +323,7 @@ puts result
|
|
322
323
|
#### Authentication
|
323
324
|
The client must be configured with a valid api access token to call this
|
324
325
|
action. The token must include at least one of the following scopes:
|
325
|
-
all.
|
326
|
+
all.User, all.User.read, me.*, or me.get.
|
326
327
|
|
327
328
|
#### Available Parameters
|
328
329
|
|
@@ -359,7 +360,7 @@ puts result
|
|
359
360
|
#### Authentication
|
360
361
|
The client must be configured with a valid api access token to call this
|
361
362
|
action. The token must include at least one of the following scopes:
|
362
|
-
all.
|
363
|
+
all.User, me.*, or me.patch.
|
363
364
|
|
364
365
|
#### Available Parameters
|
365
366
|
|
@@ -397,7 +398,7 @@ puts result
|
|
397
398
|
#### Authentication
|
398
399
|
The client must be configured with a valid api access token to call this
|
399
400
|
action. The token must include at least one of the following scopes:
|
400
|
-
all.
|
401
|
+
all.User, all.User.read, me.*, or me.payloadCounts.
|
401
402
|
|
402
403
|
#### Available Parameters
|
403
404
|
|
@@ -421,6 +422,42 @@ all.SolutionUser, all.User, all.User.read, me.*, or me.payloadCounts.
|
|
421
422
|
|
422
423
|
<br/>
|
423
424
|
|
425
|
+
## Refresh Token
|
426
|
+
|
427
|
+
Returns a new auth token based on the current auth token
|
428
|
+
|
429
|
+
```ruby
|
430
|
+
result = client.me.refresh_token(optional_params)
|
431
|
+
|
432
|
+
puts result
|
433
|
+
```
|
434
|
+
|
435
|
+
#### Authentication
|
436
|
+
The client must be configured with a valid api access token to call this
|
437
|
+
action. The token must include at least one of the following scopes:
|
438
|
+
all.User, or me.*.
|
439
|
+
|
440
|
+
#### Available Parameters
|
441
|
+
|
442
|
+
| Name | Type | Required | Description | Default | Example |
|
443
|
+
| ---- | ---- | -------- | ----------- | ------- | ------- |
|
444
|
+
| losantdomain | string | N | Domain scope of request (rarely needed) | | example.com |
|
445
|
+
|
446
|
+
#### Successful Responses
|
447
|
+
|
448
|
+
| Code | Type | Description |
|
449
|
+
| ---- | ---- | ----------- |
|
450
|
+
| 200 | [Authenticated User](_schemas.md#authenticated-user) | Successful token regeneration |
|
451
|
+
|
452
|
+
#### Error Responses
|
453
|
+
|
454
|
+
| Code | Type | Description |
|
455
|
+
| ---- | ---- | ----------- |
|
456
|
+
| 400 | [Error](_schemas.md#error) | Error if malformed request |
|
457
|
+
| 401 | [Error](_schemas.md#error) | Unauthorized error if authentication fails |
|
458
|
+
|
459
|
+
<br/>
|
460
|
+
|
424
461
|
## Transfer Resources
|
425
462
|
|
426
463
|
Moves resources to a new owner
|
@@ -434,7 +471,7 @@ puts result
|
|
434
471
|
#### Authentication
|
435
472
|
The client must be configured with a valid api access token to call this
|
436
473
|
action. The token must include at least one of the following scopes:
|
437
|
-
all.
|
474
|
+
all.User, me.*, or me.transferResources.
|
438
475
|
|
439
476
|
#### Available Parameters
|
440
477
|
|
@@ -470,7 +507,7 @@ puts result
|
|
470
507
|
#### Authentication
|
471
508
|
The client must be configured with a valid api access token to call this
|
472
509
|
action. The token must include at least one of the following scopes:
|
473
|
-
all.
|
510
|
+
all.User, me.*, or me.verifyEmail.
|
474
511
|
|
475
512
|
#### Available Parameters
|
476
513
|
|