logo

Repository

This document describes the API for reading and updating Repositories.

List Repositories

Returns a list of Repositories.

Search parameters

Filter Description
created_at The date this Repository was created
id The ID of the Repository
in_audit_scope Flag to indicate if the Repository is in audit scope
name The name of the repository
owner_name The Repository owner's name
private Flag to indicate if the Repository is private
updated_at The date this Repository was last updated
vendor_name The name of the vendor that this Repository is from
Securityheader_authorization
Request
query Parameters
include
boolean

Set to true along with relationships to return the entire relationship data in the included key within the response.

page
integer

Used for pagination of response data (default: page 1). Specifies the offset of the next block of data to receive.

per_page
integer

Used for pagination of response data (default: 1000 items per response). Specifies the number of results for a given page.

q
string

Search and filter the Repository data using Lucene syntax.

relationships
boolean

Set to true to return the associated relationships data within the response. (default: false)

Responses
400

Bad Request

401

Unauthorized

403

Forbidden

default
get/repositories
Request samples 
Response samples 
application/json
[
  • {
    }
]
Get a Repository
Returns a single Repository by ID


Securityheader_authorization 
Request 
path Parameters
id
required
string
Scope response to id


 
Responses 
400
Bad Request


401
Unauthorized


403
Forbidden


404
Resource not found


default
get/repositories/{id}
Request samples 
Response samples 
application/json
{
  • "data": {
    },
  • "includes": { }
}
Update a Repository
Update a Repository by ID


Securityheader_authorization 
Request 
path Parameters
id
required
string
Scope response to id


 
query Parameters
in_audit_scope
boolean
Flag to indicate if this Repository is in scope.


 
out_of_audit_scope_reason
string
Out of scope reason if the repository is not in scope.


 Enum: "development_asset" "staging_asset" "out_of_scope_production_asset"  
owner_id
string <uuid> 
ID of the User that's the owner of this repository.


 
Responses 
400
Bad Request


401
Unauthorized


403
Forbidden


404
Resource not found


default
put/repositories/{id}
Request samples 
Response samples 
application/json
{
  • "data": {
    },
  • "includes": { }
}
➔ Next to Test