Revisions

Create a new revision for a project.

Each revision is a distinct snapshot. Re-using an existing version label is allowed; the new revision becomes the latest entry in that version's history (older revisions are kept).

post/v1/projects/{projectId}/revisions

Request

  • Base URL: https://api.scatool.com
  • URL: https://api.scatool.com/v1/projects/{projectId}/revisions
  • Auth: HTTP bearer

Path parameters

projectIdstring uuid required

Request body

typestring required
uploadIdstring uuid required
versionstring required

Version label, typically a Git tag or release name (e.g., v1.4.2). Re-using an existing version creates a new revision in that version's history.

Response

The request has succeeded and a new resource has been created as a result.

idstring uuid required
projectIdstring uuid required
type'sbom' | 'archive' | 'git' required

The kind of input that backs a revision.

status'created' | 'analyzing' | 'scanning' | 'completed' | 'failed' required

The state of a revision's analysis pipeline.

createdAtstring date-time required
updatedAtstring date-time required

Changes

No recorded changes to this operation across all 2 revisions of this API.