Partially update a npm upstream config for this repository.

patch

https://api.cloudsmith.io/repos/{owner}/{identifier}/upstream/npm/{slug_perm}/

Path Params

owner

string

required

identifier

string

required

slug_perm

string

required

Body Params

auth_mode

string

enum

Defaults to None

The authentication mode to use when accessing this upstream.

Allowed:

auth_secret

string | null

Secret to provide with requests to upstream.

auth_username

string | null

Username to provide with requests to upstream.

extra_header_1

string | null

The key for extra header #1 to send to upstream.

extra_header_2

string | null

The key for extra header #2 to send to upstream.

extra_value_1

string | null

The value for extra header #1 to send to upstream. This is stored as plaintext, and is NOT encrypted.

extra_value_2

string | null

The value for extra header #2 to send to upstream. This is stored as plaintext, and is NOT encrypted.

is_active

boolean

Whether or not this upstream is active and ready for requests.

mode

string

enum

Defaults to Proxy Only

The mode that this upstream should operate in. Upstream sources can be used to proxy resolved packages, as well as operate in a proxy/cache or cache only mode.

Allowed:

name

string

length between 1 and 64

A descriptive name for this upstream source. A shortened version of this name will be used for tagging cached packages retrieved from this upstream.

priority

integer

1 to 32767

Upstream sources are selected for resolving requests by sequential order (1..n), followed by creation date.

trust_level

string

enum

Defaults to Trusted

Trust level allows for control of the visibility of upstream artifacts to native package managers. Where supported by formats, the default level (untrusted) is recommended for all upstreams, and helps to safeguard against common dependency confusion attack vectors.

Allowed:

upstream_url

uri

length between 1 and 200

The URL for this upstream source. This must be a fully qualified URL including any path elements required to reach the root of the repository.

verify_ssl

boolean

If enabled, SSL certificates are verified when requests are made to this upstream. It's recommended to leave this enabled for all public sources to help mitigate Man-In-The-Middle (MITM) attacks. Please note this only applies to HTTPS upstreams.

Responses

200OK

400Request could not be processed (see detail).

422Missing or invalid parameters (see detail).

Cloudsmith is the new standard in Package / Artifact Management and Software Distribution