Get compared snippet paths between two revisions

gethttps://app.fossa.com/api/revisions/{locator}/snippets/compare/{olderRevisionLocator}/{status}/paths

Retrieve file and directory paths for the comparison of snippets between two revisions.

Path parameters

locatorstringrequired

The base revision locator

olderRevisionLocatorstringrequired

An older revision locator from the same project

statusenumrequired

The status of snippets to retrieve

newremovedunchanged

Query parameters

pathstring

The path to filter snippets by. When omitted, paths are aggregated from the root.

idsstring[]

Filter by specific snippet IDs

packageIdsstring[]

Filter by specific snippet package IDs

searchstring

Search term for filtering snippets by package name

rejectionStatusenum[]

Filter by rejection status

packageLabelsstring[]

Filter by package labels

vendoredMatchenum[]

Filter snippets by vendored/converted match status. Accepts one or more of: | Value | Description | |-------|-------------| | `vendored` | Include snippets that exist as a vendored dependency | | `exVendored` | Exclude snippets that exist as a vendored dependency | | `converted` | Include snippets that have been converted to vendored dependencies | | `exConverted` | Exclude snippets that have been converted to vendored dependencies |

Responses

200Successfully retrieved snippet paths
pathsobject[]required

Array of file and directory paths where snippets were detected

typeenumrequired

Type of path entry

directoryfile
namestringrequired

Name of the file or directory

pathstringrequired

Full path to the file or directory

countintegerrequired

Number of snippets found at this path

400Bad Request
uuidstring

Unique identifier associated with the error

codeinteger

fossa specific error code

messagestring

message associated with this error

namestring

name of the error

httpStatusCodeinteger

http status code number

401Unauthorized
uuidstring

Unique identifier associated with the error

codeinteger

fossa specific error code

messagestring

message associated with this error

namestring

name of the error

httpStatusCodeinteger

http status code number

403Forbidden
uuidstring

Unique identifier associated with the error

codeinteger

fossa specific error code

messagestring

message associated with this error

namestring

name of the error

httpStatusCodeinteger

http status code number

404NotFound
uuidstring

Unique identifier associated with the error

codeinteger

fossa specific error code

messagestring

message associated with this error

namestring

name of the error

httpStatusCodeinteger

http status code number

Try this endpoint

Build a request and run it against app.fossa.com.

Bearer

Stored in this browser for 24 hours. Try It uses a docs proxy for CORS and does not store tokens server-side.

GET https://app.fossa.com/api/revisions/%7Blocator%7D/snippets/compare/%7BolderRevisionLocator%7D/new/paths
curl --request GET \  --url 'https://app.fossa.com/api/revisions/%7Blocator%7D/snippets/compare/%7BolderRevisionLocator%7D/new/paths' \  --header 'accept: application/json'

Real request. Mutating methods can change data.

Click Try It to run a request and see the response here.
Missing path params: locator, olderRevisionLocator

Path params

locatorstringrequired

The base revision locator

olderRevisionLocatorstringrequired

An older revision locator from the same project

statusenumrequired

The status of snippets to retrieve

Query params

pathstring

The path to filter snippets by. When omitted, paths are aggregated from the root.

idsarray

Filter by specific snippet IDs

packageIdsarray

Filter by specific snippet package IDs

searchstring

Search term for filtering snippets by package name

rejectionStatusarray

Filter by rejection status

packageLabelsarray

Filter by package labels

vendoredMatcharray

Filter snippets by vendored/converted match status. Accepts one or more of: | Value | Description | |-------|-------------| | `vendored` | Include snippets that exist as a vendored dependency | | `exVendored` | Exclude snippets that exist as a vendored dependency | | `converted` | Include snippets that have been converted to vendored dependencies | | `exConverted` | Exclude snippets that have been converted to vendored dependencies |