Allowed values: None, Username and Password Defaults to None
The authentication mode to use when accessing this upstream.
auth_secret
string | null
optional
length ≤ 4096
Secret to provide with requests to upstream.
auth_username
string | null
optional
length ≤ 64
Username to provide with requests to upstream.
created_at
date-time
optional
The datetime the upstream source was created.
disable_reason
string
optional
Allowed values: N/A, Upstream points to its own repository, Missing upstream source, Upstream was disabled by request of user Defaults to N/A
extra_header_1
string | null
optional
^[-\w]+$ length ≤ 64
The key for extra header #1 to send to upstream.
extra_header_2
string | null
optional
^[-\w]+$ length ≤ 64
The key for extra header #2 to send to upstream.
extra_value_1
string | null
optional
^[^\n\r]+$ length ≤ 128
The value for extra header #1 to send to upstream. This is stored as plaintext, and is NOT encrypted.
extra_value_2
string | null
optional
^[^\n\r]+$ length ≤ 128
The value for extra header #2 to send to upstream. This is stored as plaintext, and is NOT encrypted.
is_active
boolean
optional
Whether or not this upstream is active and ready for requests.
mode
string
optional
Allowed values: Proxy Only, Cache and Proxy 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.
name
string
required
^\w[\w \-'\.\/()]+$ 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.
pending_validation
boolean
optional
When true, this upstream source is pending validation.
priority
integer
optional
length between 1 and 32767
Upstream sources are selected for resolving requests by sequential order (1..n), followed by creation date.
slug_perm
slug
optional
^[-a-zA-Z0-9_]+$ length ≥ 1
updated_at
date-time
optional
upstream_url
uri
required
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
optional
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.
Request could not be processed (see detail).
object
object
detail
string
required
length ≥ 1
An extended message for the response.
fields
object
optional
A Dictionary of related errors where key: Field and value: Array of Errors related to that field
object
Missing or invalid parameters (see detail).
object
object
detail
string
required
length ≥ 1
An extended message for the response.
fields
object
optional
A Dictionary of related errors where key: Field and value: Array of Errors related to that field