How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Synack Assessments API

Assets are associated with listings.

Synack Assessments API is one of 22 APIs that Synack publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Assessments. The published artifact set on APIs.io includes an OpenAPI specification.

This API exposes 13 operations across 10 paths, and defines 34 schemas. It is described by OpenAPI 3.2.0, at version 1.0.

Requests are made against 6 base URLs: https://client.synack.com/api/asset, https://client.synack.us/api/asset, https://api.synack.com, https://api.synack.us, https://client.synack.com/api, https://client.synack.us/api.

13 operations 10 paths 34 schemas 2 DELETE5 GET2 PATCH2 POST2 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.0
Base URL
https://api.synack.com
Authentication
OAuth 2.0, HTTP Bearer, HTTP Basic, API Key
Resource Areas
1

Authentication & Security 4

Synack Assessments API declares 4 security schemes for authenticating requests. It supports OAuth 2.0 (OAuth2) using the implicit flow, exposing 11 scopes. It accepts HTTP bearer tokens (JWT) (BearerAuth). It accepts HTTP basic authentication (BasicAuth). An API key is passed in the header as X-Auth (ApiKeyAuth).

Paths & Operations 13

Across 10 paths, the API surfaces 13 operations — 2 DELETE, 5 GET, 2 PATCH, 2 POST, 2 PUT. Each is listed below with its method, path, parameters, and response codes.

Assessments 13

Assets are associated with listings.

PUT
/v2/listings/{listingUid}/assets/{assetUid}
Upsert assignment of an asset to a listing.
putListingAsset 2 params body → 200401403404500503
DELETE
/v2/listings/{listingUid}/assets/{assetUid}
Delete the assignment of an asset to a listing.
deleteListingAsset 2 params → 204401403404500503
PATCH
/v2/listings/{listingUid}/assets
Associate or disassociate zero or more assets from a listing. Allows the caller to provide lists of assets to add to and/or remove from being associated with a listing. Unknown assets are ignored.
patchListingAssets 1 param body → 204401403404413422500503
DELETE
/v2/listings/{listingUid}/assets
Delete all the association of assets from a listing.
deleteListingAssets 2 params → 204403404500503
PATCH
/v2/organizations/{organizationUid}/listings/{listingUid}/gateways
Associate or disassociate gateway ID from a listing. Allows the caller to provide gateway ID to add to and/or remove from being associated with a listing. Gateway ID equals to "nil" would disassociat…
patchListingGateways 2 params body → 204401403422500
PUT
/v2/listings/{listingUid}/reset-scope-rules
For every asset associated with the listing, reset the scope rules to default rules
putListingAssetsResetScopeRules 1 param → 204401403500503
GET
/v1/assessments
Get assessments (V1)
getAssessments 1 param → 200400
GET
/v1/assessments/{id}
Get a specific assessment (V1)
getAssessment 1 param → 200404
GET
/v1/assessments/{id}/testing_hours
Get testing hours for an assessment
getAssessmentTestingHours 1 param → 200
POST
/v1/assessments/{id}/updates
Create new assessment update that is visible to researchers
1 param body → 201400403404500
GET
/v2/organizations/{organizationUid}/assessments
Get assessments for an organization
getOrganizationAssessments 8 params → 200400401403404
POST
/v2/organizations/{organizationUid}/assessments
Create a new assessment
createOrganizationAssessment 1 param body → 201400422500
GET
/v2/organizations/{organizationUid}/assessments/{assessmentUid}/stats
Get assessment statistics
getAssessmentStats 2 params → 200404

Schemas 34

The contract defines 34 schemas that model the data the API accepts and returns. The most detailed are Assessment (10 properties), PaginationMetadata (9 properties), ProblemDetails (9 properties), TestCounts (5 properties). Each schema is shown below with its type and property counts.

Updatable
FailedValidation
object
3 properties 1 required
ScopeRuleApplicability
string
GatewayIDInput
object
Gateway ID to associate or remove from a listing.
1 property 1 required
WebRULE
string
Rule for web asset validation
ScopeRuleInclusion
string
ListingAsset
ListingUID
string
Unique identifier for an listing.
IndexedFailedValidations
object
2 properties
ScopeRule
Scope
string
Set to in-scope means automated and manual testing should occur; out-of-scope means automated and manual testing must not occur; discovered means observed thro…
BulkListingAsset
object
Asset UIDs to associate to and/or remove from a listing.
2 properties
ProblemDetails
object
See [RFC 7807: Problem Details for HTTP APIs](https://tools.ietf.org/html/rfc7807)
9 properties
OperationUserUID
string
Automatically set by the server to the requesting user whenever the resource is updated. May be a user account or a service account if the action is performed…
OrganizationUID
string
Unique identifier for an organization.
GatewayID
string
Identifier for Launchpoint-managed VPN gateway.
AssetListing
object
Listings the asset is assigned to.
5 properties
UID
string
Unique Identifier.
Creatable
object
2 properties 2 required
AssetUID
string
Unique identifier for an asset.
ScopeRuleSummary
object
Part of the scope of an asset that is included/excluded from a specific activity.
4 properties 4 required
AssetType
string
Tag
object
4 properties
Assessment
object
10 properties 6 required
OwnerContact
object
3 properties 3 required
TestCounts
object
5 properties 5 required
CoverageData
object
2 properties
ProblemDetails_2
object
4 properties 3 required
PaginationMetadata
object
9 properties 7 required
AssessmentStats
object
5 properties
ProblemDetailsSubProblem
object
2 properties 2 required
VulnerabilityCounts
object
3 properties
ValidationProblemDetails
MissionCounts
object
2 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

synack-assessments-api-openapi.yml Raw ↑

Other APIs Synack publishes across the network.

Synack Assessment Groups API
Synack Assessment Lifecycle API
Synack asset-relationships API
Synack assetproviders API
Synack Assets API
Synack Comments API
Synack credentials API
Synack external-relationships API
Synack health API
Synack Hosts API
Synack Missions API
Synack mobileapps API
Where this information came from

This is an independent, third-party profile of Synack Assessments API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.