Skip to content
Press.js Press.js Press.js Docs

Get deploy settings

GET
/v1/deploys/{deployId}/settings
 
curl --request GET \
  --url https://api.presscloud.example/v1/deploys/example/settings \
  --header 'Authorization: Bearer <token>'

Returns deploy-level webhook, version lifecycle, environment, and secret metadata settings. Secret values are never returned.

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters ”
deployId
required
string
>= 1 characters

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Deploy settings detail.

Media type application/json
object
settings
required
object
deployId
required
string
webhook
required
object
enabled
required
boolean
signingSecretConfigured

Whether a signing secret is configured for this webhook.

boolean
signingSecretPreview

Masked preview of the configured signing secret, for example whsec******.

string
signingSecretAction

Staged deploy-level webhook signing secret action applied when deploy settings are saved.

string
Allowed values: disable rotate
url
string format: uri
>= 1 characters
versionLifecycle
required
object
enabled
required
boolean
retainLatestVersions
required
integer
>= 1
environment
required
object
variables
required
Array<object>
object
deployId
required
string
name
required
string
/^[A-Za-z_][A-Za-z0-9_]*$/
value
required
string
createdAt
required
integer
updatedAt
required
integer
secrets
required
object
items
required
Array<object>
object
deployId
required
string
name
required
string
/^[A-Za-z_][A-Za-z0-9_]*$/
createdAt
required
integer
updatedAt
required
integer
Example 
{
  "settings": {
    "webhook": {
      "signingSecretAction": "disable"
    }
  }
}

404

Section titled “404 ”

Requested resource was not found.

Media type application/json
object
error
required
string
message
required
string
Example generated
{
  "error": "example",
  "message": "example"
}