Mend API (3.0.1)
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/orgs/{orgToken}/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 } }
org UUID (by running Entities - Organization > Get User Organizations) or API Key (from the Mend SCA App: Integrate tab > API Key).
- 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/orgs/{orgToken}/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/orgs/{orgToken}/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/orgs/{orgToken}/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" } }
- Generated server url
https://api-saas.mend.io/api/v2.0/orgs/{orgToken}/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/orgs/{orgToken}/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 } }