SEsecurityscorecard
portfolios

Create a new portfolio

Changed on
post/portfolios

Request

  • Base URL
    https://api.securityscorecard.io
  • URL
    https://api.securityscorecard.io/portfolios
  • Auth
    API key in header Authorization

Request body

namestring required

human-readable name

descriptionstring

human-readable description

privacy'private' | 'shared' | 'team'

private: only visible to owner, shared: visible to the entire organization, team: group of users within an organization

team_idstring

ID of the team that owns this portfolio

Example request

{
  "name": "Our Vendors",
  "description": "These are all the vendors we monitor for security risk",
  "privacy": "private",
  "team_id": "aea7dae2-370f-4279-a458-4c7cb9661778"
}

Response

Create a new portfolio

idstring

Identifier

namestring

human-readable name

descriptionstring

human-readable description

privacy'private' | 'shared' | 'team'

private: only visible to owner, shared: visible to the entire organization, team: group of users within an organization

tag_typestring

Example response

{
  "id": "aea7dae2-370f-4279-a458-4c7cb9661778",
  "name": "Our Vendors",
  "description": "These are all the vendors we monitor for security risk",
  "privacy": "private"
}

Changes

  • b465b4846039Revision changes
    • breaking

      added the pattern ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$ to the request property

    • breaking

      the response property became optional for the status

    • info

      media type application/json; charset=utf-8 was changed to application/json for the response status

    • info

      added the optional property to the response with the status

    • info

      the response's property pattern ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$ was added for the status