Get the goal binding for a quality profile

GET

/goals/binding

curl --request GET \
  --url 'https://example.com/api/v1/goals/binding?databaseId=1&profileName=example&arrType=radarr'

• API v1

Returns the persisted goal binding (preset + weights + engine version + applied time) for a profile, or null when the profile is not goal-governed. A stale engineVersion drives a re-apply prompt in the editor.

Parameters

Query Parameters

databaseId

required

integer

profileName

required

string

arrType

required

string

Allowed values: radarr sonarr lidarr

Responses

200

The binding, or null

Media typeapplication/json

object

binding

required

One of:

object

Persisted intent metadata for a goal-governed quality profile.

object

presetId

required

string

weights

required

object

qualityVsSize

required

integer

<= 100

compatibility

required

integer

<= 100

hdrPreference

required

integer

<= 100

unwantedStrictness

required

integer

<= 100

resolutionCeiling

required

string

Allowed values: 720p 1080p 2160p

engineVersion

required

string

appliedAt

required

ISO-8601 UTC timestamp of the last apply

string

null

null

applyStatus

One of:

object

Durable outcome of a Quality Goals apply/reconcile attempt (issue #236). Reports whether scoring changed, the binding’s terminal state, and the safe recovery action, so a partial write is never unreported.

object

applyId

required

integer

status

required

string

Allowed values: pending succeeded failed

scoringChanged

required

Whether the scoring ops reached (or may have reached) their intended terminal state.

boolean

bindingStatus

required

string

Allowed values: written pending failed

failureStage

One of:

string

string

null

null

failureReason

One of:

string

string

null

null

intentFingerprint

string

startedAt

required

string

settledAt

One of:

string

string

null

null

recovery

required

The safe operator recovery action for a failed or pending Quality Goals apply (issue #236).

object

action

required

string

Allowed values: none reconcile

endpoint

One of:

string

string

null

null

null

null

Example

{
  "binding": {
    "weights": {
      "resolutionCeiling": "720p"
    }
  },
  "applyStatus": {
    "status": "pending",
    "bindingStatus": "written",
    "recovery": {
      "action": "none"
    }
  }
}

400

Invalid query parameters

Media typeapplication/json

object

error

required

Error message

string

Example^generated

{
  "error": "example"
}