Sign in

v1

latestOpenAPI 3.0.12026-08-06151265417.9 KB
Dependencies Source Files

Remap source files at organization level

Remaps the specified source files to a target library across the entire organization. This operation runs asynchronously and returns 202 Accepted with async process status. Requires exactly one of: targetLibraryUuid OR matchSuggestionId (not both, not neither). Request body fields: sourceFileUuids (required, array), targetLibraryUuid (conditional), matchSuggestionId (conditional), comment (optional), sendEmailNotification (optional, boolean).

post/api/v3.0/orgs/{orgUuid}/dependencies/sourceFiles/remapping

Path parameters

orgUuidstring required

org UUID (from the Mend App: Administration General > Organization UUID).

Request body

targetLibraryUuidstring

The UUID of the library to which source files should be remapped. Exactly one of targetLibraryUuid or matchSuggestionId must be provided

matchSuggestionIdstring

The Id of the library to which source files should be remapped. Exactly one of targetLibraryUuid or matchSuggestionId must be provided

sourceFileUuidsstring[]
commentstring

Optional user comment explaining the reason for this remapping action

sendEmailNotificationboolean

Whether to send email notification upon completion of the remapping operation

originalLibraryUuidstring

When set (remap-all-by-library), the server resolves all source files currently mapped to this library on its own; sourceFileUuids is ignored.

Example request

{
  "targetLibraryUuid": "123e4567-e89b-12d3-a456-426655440000",
  "matchSuggestionId": "ZWJlMTZhZjYtMmE2YS00MWQ1LWFiNTQtYWQ3YWE3OWZhNzFl",
  "sourceFileUuids": [
    "123e4567-e89b-12d3-a456-426655440000"
  ],
  "sendEmailNotification": true,
  "originalLibraryUuid": "123e4567-e89b-12d3-a456-426655440000"
}

Response

Remapping job accepted and initiated

uuidstring

The unique identifier of the async process

status'PENDING' | 'IN_PROGRESS' | 'FAILED' | 'FAILURE' | 'SUCCESS'

The current status of the async process

userEmailstring

Email of the user who initiated the process

requestTokenstring

Short token for tracking the request

Example response

{
  "uuid": "caf69794-9882-4b55-82db-6b6da4fe2a92",
  "status": "PENDING",
  "userEmail": "user@example.com",
  "requestToken": "2cd6a43b"
}