Repository Credentials

Add repository to watch

post/repositories

Query parameters

repositorystring required

full repository to add e.g. docker.io/library/alpine

autosubscribeboolean

flag to enable/disable auto tag_update activation when new images from a repo are added

dryrunboolean

flag to return tags in the repository without actually watching the repository, default is false

Headers

x-anchore-accountstring

An account name to change the resource scope of the request to that account, if permissions allow (admin only)

Response

Repository and discovered tags added

subscription_keystring

The key value that the subscription references. E.g. a tag value or a repo name.

subscription_typestring

The type of the subscription

subscription_valuestring nullable

The value of the subscription target

userIdstring

The userId of the subscribed user

activeboolean

Is the subscription currently active

subscription_idstring

the unique id for this subscription record

Example response

[
  {
    "subscription_id": "subscription_id",
    "subscription_value": "subscription_value",
    "active": true,
    "subscription_key": "subscription_key",
    "subscription_type": "subscription_type",
    "userId": "userId"
  }
]

Changes

Changed in 2 of the 5 revisions of this API.77

Jul 17, 202638e5705e0b2116See the full diff
- ●
  deleted the query request parameter lookuptag
  request-parameter-removed
- ○
  added the new optional query request parameter dryrun
  new-optional-request-parameter
- ○
  removed the analysis_update enum value from the items/subscription_type response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the policy_eval enum value from the items/subscription_type response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the repo_update enum value from the items/subscription_type response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the tag_update enum value from the items/subscription_type response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the vuln_update enum value from the items/subscription_type response property for the response status 200
  response-property-enum-value-removed
This revision also has 6 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Oct 2, 201975f483ab10a061See the full diff
- ●
  deleted the query request parameter dryrun
  request-parameter-removed
- ●
  added the new analysis_update enum value to the items/subscription_type response property for the response status 200
  response-property-enum-value-added
- ●
  added the new policy_eval enum value to the items/subscription_type response property for the response status 200
  response-property-enum-value-added
- ●
  added the new repo_update enum value to the items/subscription_type response property for the response status 200
  response-property-enum-value-added
- ●
  added the new tag_update enum value to the items/subscription_type response property for the response status 200
  response-property-enum-value-added
- ●
  added the new vuln_update enum value to the items/subscription_type response property for the response status 200
  response-property-enum-value-added
- ○
  added the new optional query request parameter lookuptag
  new-optional-request-parameter
This revision also has 75 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history