Mend API (2.0)
Mend's enhanced SCA API enables automation of workflows in a REST compliant format. The API features:
- Access for any user with Mend credentials, via a user key available in the user's profile page in the Mend App.
- Improved security with a JWT token per organization, which expires every 30 minutes.
- Added scalability with support for pagination, filtering and sorting search results.
- Broader functionality available programmatically.
- New standard API documentation for easy navigation and search.
If you have a dedicated instance of Mend, contact your Mend representative to access this API on your instance.
- Generated server url
https://api-saas.mend.io/api/v2.0/projects/{projectToken}/policies/{policyUuid}
- Payload
- cURL
- JS
- Go
- Ruby
- Java 8
No request payload
{ "supportToken": "1171c60d", "retVal": { "uuid": "123e4567-e89b-12d3-a456-426655440000", "name": "A Policy", "owner": { … }, "createdAt": "2019-08-24T14:15:22Z", "priority": 1, "filter": { … }, "action": { … }, "context": { … }, "enabled": true, "modifiedAt": "2019-08-24T14:15:22Z", "modifiedBy": "jon.smith@mail.com", "aggregatedPriority": 0 } }
project UUID (by running Entities - Product > Get Product Projects) or Project Token (from the Mend SCA App: Integrate tab > Project Token).
- GAV_REGEX
- LIBRARY_REQUEST_HISTORY
- LIBRARY_STALENESS
- LICENSE
- PRIMARY_ATTRIBUTE_VALUE
- PRODUCT
- ReferenceNameRequiredException
- EFFECTIVENESS
- VULNERABILITY_SCORE
type: GAV_REGEX
- Generated server url
https://api-saas.mend.io/api/v2.0/projects/{projectToken}/policies/{policyUuid}
- Payload
- cURL
- JS
- Go
- Ruby
- Java 8
{ "name": "License Policy", "filter": { "type": "string", "groupIdRegex": "/**", "artifactIdRegex": "/**", "versionRegex": "/**" }, "action": { "type": "string" }, "enabled": true }
{ "supportToken": "1171c60d", "retVal": { "uuid": "123e4567-e89b-12d3-a456-426655440000", "name": "A Policy", "owner": { … }, "createdAt": "2019-08-24T14:15:22Z", "priority": 1, "filter": { … }, "action": { … }, "context": { … }, "enabled": true, "modifiedAt": "2019-08-24T14:15:22Z", "modifiedBy": "jon.smith@mail.com", "aggregatedPriority": 0 } }
- Generated server url
https://api-saas.mend.io/api/v2.0/projects/{projectToken}/policies/{policyUuid}
- Payload
- cURL
- JS
- Go
- Ruby
- Java 8
No request payload
{ "supportToken": "1171c60d", "retVal": { "message": "Success!" } }
- Generated server url
https://api-saas.mend.io/api/v2.0/projects/{projectToken}/policies/apply
- Payload
- cURL
- JS
- Go
- Ruby
- Java 8
No request payload
{ "supportToken": "1171c60d", "retVal": { "contextUuid": "caf69794-9882-4b55-82db-6b6da4fe2a26", "uuid": "caf69794-9882-4b55-82db-6b6da4fe2a92", "status": "PENDING", "contextType": "DOMAIN", "created": "2019-08-24T14:15:22Z", "modified": "2019-08-24T14:15:22Z", "processType": "APPLY_POLICIES", "messageContentSha1": "fb4016165697cc32d0b90ccc82e3c2c846eb01b7", "requestToken": "2cd6a43b", "userEmail": "sample@mail.com" } }
Filter your search to return items whose property has a specific value. Use the syntax: property:operation:value where a colon (:) separates between property, operation and value.
- Property: the name of the property of the item
- Operation:
- equals - true if the value is identical to this value.
- Value: the value of the property.
This endpoint supports filtering on the following properties and its supported operators:
- aggregatePolicies:[equals]:value. Value can be either true or false
- Generated server url
https://api-saas.mend.io/api/v2.0/projects/{projectToken}/policies
- Payload
- cURL
- JS
- Go
- Ruby
- Java 8
No request payload
{ "supportToken": "1171c60d", "retVal": [ { … } ] }
- GAV_REGEX
- LIBRARY_REQUEST_HISTORY
- LIBRARY_STALENESS
- LICENSE
- PRIMARY_ATTRIBUTE_VALUE
- PRODUCT
- ReferenceNameRequiredException
- EFFECTIVENESS
- VULNERABILITY_SCORE
type: GAV_REGEX
- Generated server url
https://api-saas.mend.io/api/v2.0/projects/{projectToken}/policies
- Payload
- cURL
- JS
- Go
- Ruby
- Java 8
{ "name": "License Policy", "filter": { "type": "string", "groupIdRegex": "/**", "artifactIdRegex": "/**", "versionRegex": "/**" }, "action": { "type": "string" }, "enabled": true }
{ "supportToken": "1171c60d", "retVal": { "uuid": "123e4567-e89b-12d3-a456-426655440000", "name": "A Policy", "owner": { … }, "createdAt": "2019-08-24T14:15:22Z", "priority": 1, "filter": { … }, "action": { … }, "context": { … }, "enabled": true, "modifiedAt": "2019-08-24T14:15:22Z", "modifiedBy": "jon.smith@mail.com", "aggregatedPriority": 0 } }