Skip to main content

Unity API Forum

Designed to discuss Webroot Unity API features, general questions, and ideas

  • 93 Topics
  • 222 Replies
93 Topics
cbullas
cbullasRetired Webrooter
published in Unity API Forum
Unity API - Open API preview release

As part of making it easier to use the Unity API we have released a preview version of Open API support.  Here are a few details. Unity API users can now start with a documented ‘API library’ instead of having to set everything up from scratch, making it easier to generate code/scripts,  use testing tools and self-educate. Open API is supported by loads of tools. Files in both JSON and YAML for flexibility For more information see https://unityapi.webrootcloudav.com/Docs/en/APIDoc/APIReference#get-openapi-definition Those interested to learn about Open API https://www.openapis.org/ Note this is a public preview release, you will still need to setup access/ refresh token calls, see https://unityapi.webrootcloudav.com/Docs/en/APIDoc/GettingStarted#gettingStarted  Let us know what you think!

8644
ngoknel
Administrator
3 years ago
cbullas
cbullasRetired Webrooter
published in Unity API Forum
Universal Reporter - create customer value add reports for your customers

We have just launched our Universal Reporter tool that's been created by the Integrations team here at Webroot.  This tool allows MSPs to create custom reports that show value to your end customers. We've also made it really easy to be able to schedule and automatically email selected reports to your customers.  The tool uses the concept of templates for reports that are built using Microsoft Excel and PowerShell Scripts. Included are a sample of templates to for you to play with.  We've created our knowledge base to help you get up and running .  Download the Universal Reporter   For the coders / scripters among you check out the new Unity API SDK, PowerShell cmdlet included. It only covers reporting functions in the Unity API at present, but we would love to know what you think about it. Plus no need to worry about access and refresh tokens.   Thanks  

3720
cbullas
4 years ago
JosephRi
JosephRiRetired Webrooter
posted in Unity API Forum
IMPORTANT - Identifying your Application

[h4][b]IMPORTANT - Identifying your Application[/b][/h4] When using the Unity API you need to specify a valid user agent string for all requests in the corresponding [b]User-Agent[/b] request header. The string needs to be made up of one or more name and version pairs separated by a whitespace character (e.g. "MyCustomApplication/1.2.759 ThirdpartyPlatform/1.0.r3"), according to the HTTP/1.1 standard. Please be aware that Webroot reserves the right to reject Unity API requests that do not follow above requirement anytime in the future. Identifying your application is important and enables Webroot to provide a more targeted and streamlined API experience. If you have any questions please do not hesitate to reach out to Webroot support.

2750
JosephRi
5 years ago
S
New Member
SFCSANew Member
asked in Unity API Forum
Get-UnityAPISkyStatusReportingEndpointUsageSite Failing

Can’t create fully extended data reports. Error every time.

80
S
New Member
27 days ago
J
Fresh Face
Jared.henryFresh Face
asked in Unity API Forum
Unity API: SkyStatus request failed (No parameterless constructor defined for type of 'System.String'.)

Starting on October 12th we noticed a rise in API call failures specific to the https://unityapi.webrootcloudav.com/service/api/status/site/{GSMKey} endpoint. The receive the following response: "statusCode: 500,""requestId: '',"error: null,""error_description: ""SkyStatus request failed (No parameterless constructor defined for type of 'System.String'.)","AdditionalInformation: {}   

793
aqila
Community Manager
1 year ago
M
Fresh Face
Matthew_LangFresh Face
posted in Unity API Forum
SkyStatus request failed (No parameterless constructor defined for type of 'System.String'.)

We have been using the API https://unityapi.webrootcloudav.com/service/api/status/site/{GSMKey} for many months now and it has been working fine until this morning.I have started receiving the following response and was wondering why this woudl suddenly be the case. I am getting the same result from other API calls for the endpoint status. {    "statusCode": 500,    "requestId": ",    "error": null,    "error_description": "SkyStatus request failed (No parameterless constructor defined for type of 'System.String'.)",    "AdditionalInformation": {}} 

921
aqila
Community Manager
1 year ago
A
New Voice
ArjanNew Voice
posted in Unity API Forum
Restrict API to site

Is it possible to create an API key that has only access to a single site?

803
S
New Member
1 year ago
R
New Member
rajansajanNew Member
posted in Unity API Forum
Webroot API is not return all the end points

Hi All, I am calling the reports end point and it’s return only 6 endpoints, I have checked I have 7 active endpoints. or is there any way I can call the inactive endpoints using the API.If anybody can help?Thanks,  

963
TylerM
Administrator
1 year ago
P
New Member
papabolromeNew Member
posted in Unity API Forum
AgentStatus endpoint no QueryResults

Hello, I need to get my client’s Agentstatus data but the queryresults aren't giving me any results when trying to query it. Am I doing something wrong? Thank you! 

861
S
Webroot Employee
1 year ago
J
Fresh Face
jseumo2Fresh Face
asked in Unity API Forum
Adding a scope to an access token

Hi, I need to be able to use the notifications endpoints for the Unity API, but I am not sure where to go to add the correct scope for my testing access token. Can anyone direct me? The token already has access to the following scopes: scope": "[\"SkyStatus.Site\",\"SkyStatus.GSM\",\"SkyStatus.Usage\",\"SkyStatus.Reporting\",\"Console.GSM\"]"Thanks

1246
L
New Member
1 year ago
D
Webroot Employee
dengWebroot Employee
posted in Unity API Forum
Unity API event notification service adoption

Tell us how you are using the new Unity API event notification service.  And what are some of the new events that you like us to publish through this API endpoint? 

380
D
Webroot Employee
1 year ago
D
Webroot Employee
dengWebroot Employee
posted in Unity API Forum
what are some improvement that you want to see in Unity API

please share your thoughts

100
D
Webroot Employee
1 year ago
M
Fresh Face
Matthew_LangFresh Face
asked in Unity API Forum
Error(BLOCKEDPROGRAMS0021)

I have been using ADF to query the endpoint threat history API.https://unityapi.webrootcloudav.com//service/api/console/gsm/xxxxxx/sites/xxxxxxx/threathistoryThis has been working successfully for many weeks. we have been nearing the end of our subscription period and have been granted an extension of 30 days for our license, but now when I query this API I get the following error.Error(BLOCKEDPROGRAMS0021): Users endpoint protection access has expired"I can still get results back from other API’s I call using the same credentials so it seems isolated to the endpoint threat protection historyIs this something to do with this being a temporary license?How can I go about resolving? Many thanks Matt Lang

511
aqila
Community Manager
1 year ago
M
Fresh Face
Matthew_LangFresh Face
asked in Unity API Forum
Endpoint Status GSM Modified since parameter and return result

I am calling the Endpoint Status GSM API using postman and providing a date and time for the modifiedSince parameter. REST API Call belowGET /service/api/status/gsm/{keyCode}?batchSize=1000 &modifiedSince={modifiedSince}I would expect to see the count of records being returned to steadily increment each time I execute this request, since new records or updated records get returned,  but what I am seeing is confusing and I was hoping someone could help clarify.lets say on my first call I want to see all records that were modified since 11am today. I should see (let’s say in this use case) 100 records returned with no continuation token or URI since my batch size is set to max (1000).If I run the exact same query again a few seconds later I should see the same data or maybew 1 or 2 extra records depending on how busy my system is.What I am seeing instead is less records being returned, often along with a continuation token.I never seem to get a consistent result back, at times I see

956
M
Fresh Face
2 years ago
S
Fresh Face
Steven RFresh Face
asked in Unity API Forum
API not decoding password properly

Hi,We are trying to generate an access token for one of our clients using their username and password through the https://unityapi.webrootcloudav.com/auth/token endpoint. However, if the password contains an & symbol, we always receive the error message "Username or password is invalid”.When testing with other accounts and passwords (not containing an & character), things work fine. We double checked and we are sending the password field (as any other field) properly URL encoded. My only guess is that the receiving API server is not decoding these values correctly.Would you be able to confirm this a problem on your end or is there something we need to check again?Thanks for any help.Best regards,Steven

1488
aqila
Community Manager
2 years ago
C
Fresh Face
CSQAFresh Face
asked in Unity API Forum
Adding/removing access for Site Admin via API

I have 2 GSM Console Admins (Super Admins), 1 Site-Admin, and 2 Sites. The 1 Site admin has administrator access to both sites. I want to use the API to update their access to either No Access or View Only. When I use the endpoint “/service/api/console/gsm/{gsmKey}/sites/{siteId}/admins” (with the relevant info filled in), it’ll return a 204 but nothing updates for the Site Admin, their access stays the same.If I attempt to provision either of the GSM Console Admins using the same endpoint and changing their access level to any of the 3 levels available, it’ll work. Judging by this in the API documentation “This API method allows adding existing GSM admins to the list of admins of a site, or modifying access permissions of already set up site admins. To get information about available admins, either query the list of admins on the GSM console (see here) or the list of admins on a site (see here),”, it seems that I should be able to change a site admins access permissions… unless I’m mi

1306
S
Webroot Employee
2 years ago
L
Fresh Face
lpopejoyFresh Face
posted in Unity API Forum
Webroot dashboard

There was an impressive dashboard in the webinar showing what someone had created with the API.    Just curious if there is any chance that the person who created that is interested in licensing the code - or open sourcing it?  It would save me a week a work.  :) [img]https://d1qy7qyune0vt1.cloudfront.net/webroot-en/attachment/27861i9CD2F409C942D4A1.png[/img]

1769
L
New Member
2 years ago
C
Fresh Face
ctaylorFresh Face
asked in Unity API Forum
Unity API Scope

I am trying to suspend/deactivate sites and keep getting a scope error.I have tried scopes like:Console.GSMConsole.**But I continue to get scope errors for these endpoints. What must I do to acquire the correct scope?https://unityapi.webrootcloudav.com/service/api/console/gsm/{gsmKey}/sites/{siteId}/deactivate{ "statusCode":403, "requestId":"3c329835-981d-495e-875f-50201c49752", "error":"insufficient_scope", "error_description":"Access was denied due to insufficient token scope.", "AdditionalInformation":{}} I can change things in the site without issue but cant suspend/deactivate the site.

1223
C
Fresh Face
2 years ago
N
New Member
nitsrini698New Member
asked in Unity API Forum
Webroot threat intelligence rest api

Hi,      I know Webroot threat intelligence support Rest API for getting threat sources information .But does Webroot threat intelligence support rest API for reporting IP and URL?

2401
mattaldridge
Webroot Employee
2 years ago
P
New Member
PushkarNew Member
posted in Unity API Forum
Users endpoint protection access has expired

'{"statusCode":403,"requestId":"66597b2c-ba7e-4295-83dd-5db4fd0386c8","error":null,"error_description":"Error(LISTDEVICES0008): Users endpoint protection access has expired","AdditionalInformation":{"transname":"LISTDEVICES","languagecode":"EN"}}'II assume that this issue might have caused If the submitted access token does not contain the required scope (see Service Extensions and Scopes) for the requested API call, the server responds with an HTTP 403 (Forbidden) status code and the message "error": "insufficient_scope".  But the error here is null and the scope I passed was ‘*’.It only takes a few seconds to make that request. Span of 300sec is huge for that request, so access token expiration is unlikely to happen. I am not able to understand what `Users endpoint protection access has expired` mean.

431
ngoknel
Administrator
2 years ago
M
New Member
mbrown16037New Member
asked in Unity API Forum
ConnectWise Automate API Broken

I am no longer able to see new clients in my Automate plugin

1272
M
Fresh Face
2 years ago
G
New Member
ggroupNew Member
asked in Unity API Forum
Any Testing API keys available?

Hi wondering if there are any testing API keys available, rather than using live site and live API secret keys etc

1001
ngoknel
Administrator
3 years ago
G
New Member
GoannaNew Member
asked in Unity API Forum
Webroot Universal Reports folder does not exist

I am trying to learn how WUR works,The report runs and returns a ‘Success’ status,If I click the ‘Open’ link, it opens this folderC:\Users\fname.lname\OneDrive - MyOrganization Name Services Ltd\Documents\Webroot Reporting\Runs\20210524T0324515876892Z\Outputwhere I can see a Result.json file.   But it seems that webroot is not creating the associated excel workbook. When I look at the WebrootReporting.Log it has the following entry.24/05/2021 12:45:35 PM ResultReadingService: LoadPreviousGeneratedResults failed. Reason: C:\Users\fname.lname\OneDrive - MyOrganization Name Services Ltd\Documents\Webroot Reporting\Runs folder does not exist! The path is exactly the same in both cases. Any idea what is going on here?

601
ngoknel
Administrator
3 years ago
J
New Voice
JohnDukeNew Voice
posted in Unity API Forum
Webroot API - Add LastSeen Date in Endpoint Status GSM query

HelloI want GET a liste of EndPoints not seen since x days in GsmQuery /service/api/status/gsm/{gsmKey}&returnedInfo=BasicInfo,OSAndVersions  for all EndPoints (1400 active and many inactive) always failed before the end.Query /service/api/console/gsm/{gsmKey}/sites/{siteId}/endpoints$sSiteID for each site (280 actives) takes a very long time.Or is there a way to GET all EndPoints without error ?Thanks 

1593
ngoknel
Administrator
3 years ago
cbullas
cbullasRetired Webrooter
posted in Unity API Forum
DOWNLOAD UNITY API SDK for Microsoft .NET framework - Beta release

Hi, for those of you interested in building applications and automation quickly I’m happy to say that we have released a concept version of our SDK for you to have play with. Easily unlock the power of Webroots Unity API! Download it, have a look, have a play and please let us know what you think. This is something we are evaluating and we really care about your feedback! Please note licensing and documentation is included.

3954
J
New Member
3 years ago

Badges

Show all badges

Join the Conversation

Terms & Conditions