Get the goal binding for a quality profile

GET

/goals/binding

const url = 'https://example.com/api/v1/goals/binding?databaseId=1&profileName=example&arrType=radarr';
const options = {method: 'GET'};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

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

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

application/json

object

binding

required

One of:

object
null

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

applyStatus

One of:

object
null

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
null

string

failureReason

One of:

string
null

string

intentFingerprint

string

startedAt

required

string

settledAt

One of:

string
null

string

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
null

string

Example

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

400

Invalid query parameters

application/json

object

error

required

Error message

string

code

Stable machine-readable code present on 5xx responses; error is a fixed user-safe message, raw detail is logged server-side only

string

Allowed values: cleanup_failed library_fetch_failed episodes_fetch_failed releases_fetch_failed

Example

{
  "code": "cleanup_failed"
}