Create Watch

Creates a new Watch. A Watch defines a set of resources (repositories, builds, release bundles, projects) to be monitored by assigned security and license policies.

Notes:

  • For Xray version 3.21.2 and above with Projects, a Project Admin with Manage Security Assets privilege can create a Watch in the scope of a project by using the projectKey query parameter.
  • A Watch can include both Global and Project Policies.

Requires the 'Manage Watches' role to be set on the User or Group level.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
string

Project key for creating a Watch in the scope of a project.

Body Params

Request body for creating or updating a Watch in Xray.

general_data
object
required

General information about the Watch.

project_resources
object

Resources the Watch monitors and their filters.

assigned_policies
array of objects

Policies assigned to the Watch.

assigned_policies
watch_recipients
array of strings

Email addresses that will receive Watch notifications.

watch_recipients
boolean

Indicates whether Jira ticket creation is enabled for this Watch.

string

Jira profile name for ticket generation.

ticket_generation
object

Ticket generation settings for the Watch.

Responses

Language
Credentials
Basic
base64
:
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json