Admin Console

Generated admin console operations.

GET/v1/admin/console/accountsRead server console accountsadmin
Audience
Clients · Native API
Authorization
API key or personal access token with the admin scope, or a signed-in session
OpenAPI operation ID
get_admin_console_accounts

Responses

200Successapplication/json

Example
{
  "data": [
    {
      "id": "id_8h2k4q",
      "label": "string"
    }
  ],
  "scope": {
    "serverId": "id_8h2k4q",
    "viewerFence": "string"
  }
}
Schema
  • dataarray of objectrequired
    • idstringrequired
    • labelstringrequired
  • scopeobjectrequired
    • serverIdstringrequired
    • viewerFencestringrequired

defaultRequest refused or unavailableapplication/json

Example
{
  "error": {
    "code": "string",
    "message": "string"
  }
}
Schema
  • errorobjectrequired
    • codestringrequired
    • messagestringrequired

Error codesinvalid_requestunauthorizednot_permittednot_foundinternaldatabase_busy

Example request

curl -X GET "http://127.0.0.1:32500/v1/admin/console/accounts" \
  -H "Authorization: Bearer $PORTICO_API_KEY"
GET/v1/admin/console/alertsRead or update the selected projectionadmin
Audience
Clients · Native API
Authorization
API key or personal access token with the admin scope, or a signed-in session
OpenAPI operation ID
get_admin_console_alerts

Responses

200Successapplication/json

Example
{
  "data": [
    {
      "code": "string",
      "firstAt": "2026-10-18T19:30:00Z",
      "id": "id_8h2k4q",
      "lastAt": "2026-10-18T19:30:00Z",
      "occurrences": 0,
      "params": {
        "key": "string"
      },
      "revision": 0,
      "severity": "string",
      "status": "string"
    }
  ],
  "scope": {
    "serverId": "id_8h2k4q",
    "viewerFence": "string"
  }
}
Schema
  • dataarray of objectrequired
    • codestringrequired
    • firstAtstringrequired

      RFC 3339 UTC instant; empty when absent.

    • idstringrequired
    • lastAtstringrequired

      RFC 3339 UTC instant; empty when absent.

    • occurrencesintegerrequired
    • paramsobjectrequired
    • revisionintegerrequired
    • severitystringrequired
    • statusstringrequired
  • scopeobjectrequired
    • serverIdstringrequired
    • viewerFencestringrequired

defaultRequest refused or unavailableapplication/json

Example
{
  "error": {
    "code": "string",
    "message": "string"
  }
}
Schema
  • errorobjectrequired
    • codestringrequired
    • messagestringrequired

Error codesinvalid_requestunauthorizednot_permittednot_foundinternaldatabase_busy

Example request

curl -X GET "http://127.0.0.1:32500/v1/admin/console/alerts" \
  -H "Authorization: Bearer $PORTICO_API_KEY"
POST/v1/admin/console/alerts/{id}/acknowledgeRun server console alerts acknowledgeadmin
Audience
Clients · Native API
Authorization
API key or personal access token with the admin scope, or a signed-in session
OpenAPI operation ID
post_admin_console_alerts_id_acknowledge
Max body
64 KiB

Parameters

NameInTypeDescription
idrequiredpathstring

Request body application/json · required

Example
{
  "expectedRevision": 0,
  "idempotencyKey": "string"
}
Schema
  • expectedRevisionintegerrequired
  • idempotencyKeystringrequired

Responses

200Successapplication/json

Example
{
  "data": {
    "key": true
  },
  "scope": {
    "serverId": "id_8h2k4q",
    "viewerFence": "string"
  }
}
Schema
  • dataobjectrequired
  • scopeobjectrequired
    • serverIdstringrequired
    • viewerFencestringrequired

defaultRequest refused or unavailableapplication/json

Example
{
  "error": {
    "code": "string",
    "message": "string"
  }
}
Schema
  • errorobjectrequired
    • codestringrequired
    • messagestringrequired

Error codesinvalid_requestunauthorizednot_permittednot_foundinternaldatabase_busywriter_capacity

Example request

curl -X POST "http://127.0.0.1:32500/v1/admin/console/alerts/{id}/acknowledge" \
  -H "Authorization: Bearer $PORTICO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"expectedRevision":0,"idempotencyKey":"string"}'
GET/v1/admin/console/diagnostics/{lane}Read or update the selected projectionadmin
Audience
Clients · Native API
Authorization
API key or personal access token with the admin scope, or a signed-in session
OpenAPI operation ID
get_admin_console_diagnostics_lane

Parameters

NameInTypeDescription
lanerequiredpathstring
cursorquerystring

Responses

200Successapplication/json

Example
{
  "data": {
    "items": [
      {
        "at": "2026-10-18T19:30:00Z",
        "code": "string",
        "component": "string",
        "fields": {
          "key": 0
        },
        "lane": "string",
        "sequence": 0,
        "severity": "string"
      }
    ],
    "nextCursor": "eyJvIjoyMH0"
  },
  "scope": {
    "serverId": "id_8h2k4q",
    "viewerFence": "string"
  }
}
Schema
  • dataobjectrequired
    • itemsarray of objectrequired
      • atstringrequired

        RFC 3339 UTC instant; empty when absent.

      • codestringrequired
      • componentstringrequired
      • fieldsobjectrequired
      • lanestringrequired
      • sequenceintegerrequired
      • severitystringrequired
    • nextCursorstringrequired
  • scopeobjectrequired
    • serverIdstringrequired
    • viewerFencestringrequired

defaultRequest refused or unavailableapplication/json

Example
{
  "error": {
    "code": "string",
    "message": "string"
  }
}
Schema
  • errorobjectrequired
    • codestringrequired
    • messagestringrequired

Error codesinvalid_requestunauthorizednot_permittednot_foundinternaldatabase_busy

Example request

curl -X GET "http://127.0.0.1:32500/v1/admin/console/diagnostics/{lane}" \
  -H "Authorization: Bearer $PORTICO_API_KEY"
POST/v1/admin/console/diagnostics/captureRead or update the selected projectionadmin
Audience
Clients · Native API
Authorization
API key or personal access token with the admin scope, or a signed-in session
OpenAPI operation ID
post_admin_console_diagnostics_capture
Max body
1 MiB

Request body application/json · required

Example
{
  "component": "scheduler",
  "expiresAt": "2026-10-18T19:30:00Z",
  "idempotencyKey": "string"
}
Schema
  • componentstringrequiredone of "scheduler"
  • expiresAtstringrequired

    RFC 3339 UTC instant; empty when absent.

  • idempotencyKeystring

Responses

200Successapplication/json

Example
{
  "data": {
    "component": "scheduler",
    "expiresAt": "2026-10-18T19:30:00Z",
    "idempotencyKey": "string"
  },
  "scope": {
    "serverId": "id_8h2k4q",
    "viewerFence": "string"
  }
}
Schema
  • dataobjectrequired
    • componentstringrequiredone of "scheduler"
    • expiresAtstringrequired

      RFC 3339 UTC instant; empty when absent.

    • idempotencyKeystring
  • scopeobjectrequired
    • serverIdstringrequired
    • viewerFencestringrequired

defaultRequest refused or unavailableapplication/json

Example
{
  "error": {
    "code": "string",
    "message": "string"
  }
}
Schema
  • errorobjectrequired
    • codestringrequired
    • messagestringrequired

Error codesinvalid_requestunauthorizednot_permittednot_foundinternaldatabase_busywriter_capacity

Example request

curl -X POST "http://127.0.0.1:32500/v1/admin/console/diagnostics/capture" \
  -H "Authorization: Bearer $PORTICO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"component":"scheduler","expiresAt":"2026-10-18T19:30:00Z","idempotencyKey":"string"}'
POST/v1/admin/console/exportsRead or update the selected projectionadmin
Audience
Clients · Native API
Authorization
API key or personal access token with the admin scope, or a signed-in session
OpenAPI operation ID
post_admin_console_exports
Max body
1 MiB

Request body application/json · required

Example
{
  "components": [
    "string"
  ],
  "from": "string",
  "idempotencyKey": "string",
  "includePaths": true,
  "to": "string"
}
Schema
  • componentsarray of stringrequired
  • fromstringrequired

    RFC 3339 UTC instant; empty when absent.

  • idempotencyKeystringrequired
  • includePathsboolean
  • tostringrequired

    RFC 3339 UTC instant; empty when absent.

Responses

200Successapplication/json

Example
{
  "data": {
    "audit": {
      "items": [
        {
          "action": "string",
          "actor": "string",
          "at": "2026-10-18T19:30:00Z",
          "hash": "string",
          "id": "id_8h2k4q",
          "previousHash": "string",
          "revision": 0,
          "sequence": 0,
          "target": "string"
        }
      ],
      "nextCursor": "eyJvIjoyMH0"
    },
    "auditAnchor": {
      "hash": "string",
      "sequence": 0
    },
    "client": {
      "items": [
        {
          "at": "2026-10-18T19:30:00Z",
          "code": "string",
          "component": "string",
          "fields": {},
          "lane": "string",
          "sequence": 0,
          "severity": "string"
        }
      ],
      "nextCursor": "eyJvIjoyMH0"
    },
    "expiresAt": "2026-10-18T19:30:00Z",
    "id": "id_8h2k4q",
    "manifest": {
      "excluded": [
        "string"
      ],
      "from": "string",
      "includePaths": true,
      "included": [
        "string"
      ],
      "maxBytes": 0,
      "pathCategories": [
        "library-configured-root"
      ],
      "pathsInvalidAmongExamined": 0,
      "pathsScanTruncated": true,
      "pathsTruncated": true,
      "redaction": "string",
      "to": "string",
      "version": "string"
    },
    "runtime": {
      "items": [
        {
          "at": "2026-10-18T19:30:00Z",
          "code": "string",
          "component": "string",
          "fields": {},
          "lane": "string",
          "sequence": 0,
          "severity": "string"
        }
      ],
      "nextCursor": "eyJvIjoyMH0"
    },
    "snapshot": {
      "build": {
        "buildId": "id_8h2k4q",
        "builtAt": "2026-10-18T19:30:00Z",
        "goVersion": "string",
        "sourceDigest": "string",
        "targetArch": "string",
        "targetOS": "string",
        "version": "string"
      },
      "database": "string",
      "hostedConfigured": true,
      "libraries": {
        "byState": {
          "key": 0
        },
        "total": 0
      },
      "mounts": {
        "available": true,
        "counts": {
          "byState": {},
          "total": 0
        }
      },
      "observedAt": "2026-10-18T19:30:00Z",
      "recentScanFailures": {
        "hasMore": true,
        "items": [
          {}
        ],
        "limit": 0
      },
      "scans": {
        "byState": {
          "key": 0
        },
        "total": 0
      },
      "schemaVersion": 0
    },
    "snapshotPaths": {
      "examined": 0,
      "hasMore": true,
      "invalidAmongExamined": 0,
      "items": [
        {
          "category": "library-configured-root",
          "reference": "string",
          "value": "string"
        }
      ],
      "limit": 0,
      "scanBudget": 0,
      "scanTruncated": true
    }
  },
  "scope": {
    "serverId": "id_8h2k4q",
    "viewerFence": "string"
  }
}
Schema
  • dataobjectrequired
    • auditobject
      • itemsarray of objectrequired
        • actionstringrequired
        • actorstringrequired
        • atstringrequired

          RFC 3339 UTC instant; empty when absent.

        • hashstringrequired
        • idstringrequired
        • previousHashstringrequired
        • revisionintegerrequired
        • sequenceintegerrequired
        • targetstringrequired
      • nextCursorstringrequired
    • auditAnchorobject
      • hashstringrequired
      • sequenceintegerrequired
    • clientobject
      • itemsarray of objectrequired
        • atstringrequired

          RFC 3339 UTC instant; empty when absent.

        • codestringrequired
        • componentstringrequired
        • fieldsobjectrequired
        • lanestringrequired
        • sequenceintegerrequired
        • severitystringrequired
      • nextCursorstringrequired
    • expiresAtstringrequired

      RFC 3339 UTC instant; empty when absent.

    • idstringrequired
    • manifestobjectrequired
      • excludedarray of stringrequired
      • fromstringrequired

        RFC 3339 UTC instant; empty when absent.

      • includePathsboolean
      • includedarray of stringrequired
      • maxBytesintegerrequired
      • pathCategoriesarray of string
      • pathsInvalidAmongExaminedinteger
      • pathsScanTruncatedboolean
      • pathsTruncatedboolean
      • redactionstringrequired
      • tostringrequired

        RFC 3339 UTC instant; empty when absent.

      • versionstringrequired
    • runtimeobject
      • itemsarray of objectrequired
        • atstringrequired

          RFC 3339 UTC instant; empty when absent.

        • codestringrequired
        • componentstringrequired
        • fieldsobjectrequired
        • lanestringrequired
        • sequenceintegerrequired
        • severitystringrequired
      • nextCursorstringrequired
    • snapshotobject
      • buildobjectrequired
        • buildIdstring | any | nullrequired
        • builtAtstring | any | nullrequired
        • goVersionstring | any | nullrequired
        • sourceDigeststring | any | nullrequired
        • targetArchstringrequired
        • targetOSstringrequired
        • versionstring | any | nullrequired
      • databasestringrequired
      • hostedConfiguredbooleanrequired
      • librariesobjectrequired
        • byStateobjectrequired
        • totalintegerrequired
      • mountsobjectrequired
        • availablebooleanrequired
        • countsobject | any | nullrequired
          • byStateobjectrequired
          • totalintegerrequired
      • observedAtstringrequired
      • recentScanFailuresobjectrequired
        • hasMorebooleanrequired
        • itemsarray of objectrequired
          • codestringrequired
          • createdAtstring | any | nullrequired
          • finishedAtstring | any | nullrequired
          • processedinteger | any | nullrequired
          • updatedAtstring | any | nullrequired
        • limitintegerrequired
      • scansobjectrequired
        • byStateobjectrequired
        • totalintegerrequired
      • schemaVersionintegerrequired
    • snapshotPathsobject
      • examinedintegerrequired
      • hasMorebooleanrequired
      • invalidAmongExaminedintegerrequired
      • itemsarray of objectrequired
        • categorystringrequiredone of "library-configured-root", "library-resolved-root", "managed-mount-point"
        • referencestringrequired
        • valuestringrequired
      • limitintegerrequired
      • scanBudgetintegerrequired
      • scanTruncatedbooleanrequired
  • scopeobjectrequired
    • serverIdstringrequired
    • viewerFencestringrequired

defaultRequest refused or unavailableapplication/json

Example
{
  "error": {
    "code": "string",
    "message": "string"
  }
}
Schema
  • errorobjectrequired
    • codestringrequired
    • messagestringrequired

Error codesinvalid_requestunauthorizednot_permittednot_foundinternaldatabase_busywriter_capacity

Example request

curl -X POST "http://127.0.0.1:32500/v1/admin/console/exports" \
  -H "Authorization: Bearer $PORTICO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"components":["string"],"from":"string","idempotencyKey":"string","includePaths":true,"to":"string"}'
GET/v1/admin/console/exports/{id}Read or update the selected projectionadmin
Audience
Clients · Native API
Authorization
API key or personal access token with the admin scope, or a signed-in session
OpenAPI operation ID
get_admin_console_exports_id

Parameters

NameInTypeDescription
idrequiredpathstring

Responses

200Successapplication/json

Example
{
  "data": {
    "audit": {
      "items": [
        {
          "action": "string",
          "actor": "string",
          "at": "2026-10-18T19:30:00Z",
          "hash": "string",
          "id": "id_8h2k4q",
          "previousHash": "string",
          "revision": 0,
          "sequence": 0,
          "target": "string"
        }
      ],
      "nextCursor": "eyJvIjoyMH0"
    },
    "auditAnchor": {
      "hash": "string",
      "sequence": 0
    },
    "client": {
      "items": [
        {
          "at": "2026-10-18T19:30:00Z",
          "code": "string",
          "component": "string",
          "fields": {},
          "lane": "string",
          "sequence": 0,
          "severity": "string"
        }
      ],
      "nextCursor": "eyJvIjoyMH0"
    },
    "expiresAt": "2026-10-18T19:30:00Z",
    "id": "id_8h2k4q",
    "manifest": {
      "excluded": [
        "string"
      ],
      "from": "string",
      "includePaths": true,
      "included": [
        "string"
      ],
      "maxBytes": 0,
      "pathCategories": [
        "library-configured-root"
      ],
      "pathsInvalidAmongExamined": 0,
      "pathsScanTruncated": true,
      "pathsTruncated": true,
      "redaction": "string",
      "to": "string",
      "version": "string"
    },
    "runtime": {
      "items": [
        {
          "at": "2026-10-18T19:30:00Z",
          "code": "string",
          "component": "string",
          "fields": {},
          "lane": "string",
          "sequence": 0,
          "severity": "string"
        }
      ],
      "nextCursor": "eyJvIjoyMH0"
    },
    "snapshot": {
      "build": {
        "buildId": "id_8h2k4q",
        "builtAt": "2026-10-18T19:30:00Z",
        "goVersion": "string",
        "sourceDigest": "string",
        "targetArch": "string",
        "targetOS": "string",
        "version": "string"
      },
      "database": "string",
      "hostedConfigured": true,
      "libraries": {
        "byState": {
          "key": 0
        },
        "total": 0
      },
      "mounts": {
        "available": true,
        "counts": {
          "byState": {},
          "total": 0
        }
      },
      "observedAt": "2026-10-18T19:30:00Z",
      "recentScanFailures": {
        "hasMore": true,
        "items": [
          {}
        ],
        "limit": 0
      },
      "scans": {
        "byState": {
          "key": 0
        },
        "total": 0
      },
      "schemaVersion": 0
    },
    "snapshotPaths": {
      "examined": 0,
      "hasMore": true,
      "invalidAmongExamined": 0,
      "items": [
        {
          "category": "library-configured-root",
          "reference": "string",
          "value": "string"
        }
      ],
      "limit": 0,
      "scanBudget": 0,
      "scanTruncated": true
    }
  },
  "scope": {
    "serverId": "id_8h2k4q",
    "viewerFence": "string"
  }
}
Schema
  • dataobjectrequired
    • auditobject
      • itemsarray of objectrequired
        • actionstringrequired
        • actorstringrequired
        • atstringrequired

          RFC 3339 UTC instant; empty when absent.

        • hashstringrequired
        • idstringrequired
        • previousHashstringrequired
        • revisionintegerrequired
        • sequenceintegerrequired
        • targetstringrequired
      • nextCursorstringrequired
    • auditAnchorobject
      • hashstringrequired
      • sequenceintegerrequired
    • clientobject
      • itemsarray of objectrequired
        • atstringrequired

          RFC 3339 UTC instant; empty when absent.

        • codestringrequired
        • componentstringrequired
        • fieldsobjectrequired
        • lanestringrequired
        • sequenceintegerrequired
        • severitystringrequired
      • nextCursorstringrequired
    • expiresAtstringrequired

      RFC 3339 UTC instant; empty when absent.

    • idstringrequired
    • manifestobjectrequired
      • excludedarray of stringrequired
      • fromstringrequired

        RFC 3339 UTC instant; empty when absent.

      • includePathsboolean
      • includedarray of stringrequired
      • maxBytesintegerrequired
      • pathCategoriesarray of string
      • pathsInvalidAmongExaminedinteger
      • pathsScanTruncatedboolean
      • pathsTruncatedboolean
      • redactionstringrequired
      • tostringrequired

        RFC 3339 UTC instant; empty when absent.

      • versionstringrequired
    • runtimeobject
      • itemsarray of objectrequired
        • atstringrequired

          RFC 3339 UTC instant; empty when absent.

        • codestringrequired
        • componentstringrequired
        • fieldsobjectrequired
        • lanestringrequired
        • sequenceintegerrequired
        • severitystringrequired
      • nextCursorstringrequired
    • snapshotobject
      • buildobjectrequired
        • buildIdstring | any | nullrequired
        • builtAtstring | any | nullrequired
        • goVersionstring | any | nullrequired
        • sourceDigeststring | any | nullrequired
        • targetArchstringrequired
        • targetOSstringrequired
        • versionstring | any | nullrequired
      • databasestringrequired
      • hostedConfiguredbooleanrequired
      • librariesobjectrequired
        • byStateobjectrequired
        • totalintegerrequired
      • mountsobjectrequired
        • availablebooleanrequired
        • countsobject | any | nullrequired
          • byStateobjectrequired
          • totalintegerrequired
      • observedAtstringrequired
      • recentScanFailuresobjectrequired
        • hasMorebooleanrequired
        • itemsarray of objectrequired
          • codestringrequired
          • createdAtstring | any | nullrequired
          • finishedAtstring | any | nullrequired
          • processedinteger | any | nullrequired
          • updatedAtstring | any | nullrequired
        • limitintegerrequired
      • scansobjectrequired
        • byStateobjectrequired
        • totalintegerrequired
      • schemaVersionintegerrequired
    • snapshotPathsobject
      • examinedintegerrequired
      • hasMorebooleanrequired
      • invalidAmongExaminedintegerrequired
      • itemsarray of objectrequired
        • categorystringrequiredone of "library-configured-root", "library-resolved-root", "managed-mount-point"
        • referencestringrequired
        • valuestringrequired
      • limitintegerrequired
      • scanBudgetintegerrequired
      • scanTruncatedbooleanrequired
  • scopeobjectrequired
    • serverIdstringrequired
    • viewerFencestringrequired

defaultRequest refused or unavailableapplication/json

Example
{
  "error": {
    "code": "string",
    "message": "string"
  }
}
Schema
  • errorobjectrequired
    • codestringrequired
    • messagestringrequired

Error codesinvalid_requestunauthorizednot_permittednot_foundinternaldatabase_busy

Example request

curl -X GET "http://127.0.0.1:32500/v1/admin/console/exports/{id}" \
  -H "Authorization: Bearer $PORTICO_API_KEY"
GET/v1/admin/console/job-kindsRead server console job kindsadmin
Audience
Clients · Native API
Authorization
API key or personal access token with the admin scope, or a signed-in session
OpenAPI operation ID
get_admin_console_job_kinds

Responses

200Successapplication/json

Example
{
  "data": [
    {
      "kind": "string",
      "lane": "string",
      "resourceRequired": true
    }
  ],
  "scope": {
    "serverId": "id_8h2k4q",
    "viewerFence": "string"
  }
}
Schema
  • dataarray of objectrequired
    • kindstringrequired
    • lanestringrequired
    • resourceRequiredbooleanrequired
  • scopeobjectrequired
    • serverIdstringrequired
    • viewerFencestringrequired

defaultRequest refused or unavailableapplication/json

Example
{
  "error": {
    "code": "string",
    "message": "string"
  }
}
Schema
  • errorobjectrequired
    • codestringrequired
    • messagestringrequired

Error codesinvalid_requestunauthorizednot_permittednot_foundinternaldatabase_busy

Example request

curl -X GET "http://127.0.0.1:32500/v1/admin/console/job-kinds" \
  -H "Authorization: Bearer $PORTICO_API_KEY"
GET/v1/admin/console/jobsRead or update the selected projectionadmin
Audience
Integrations · Native API
Authorization
API key or personal access token with the admin scope, or a signed-in session
OpenAPI operation ID
get_admin_console_jobs

Parameters

NameInTypeDescription
cursorquerystring

Responses

200Successapplication/json

Example
{
  "data": {
    "items": [
      {
        "actions": [
          "string"
        ],
        "attempt": 0,
        "createdAt": "2026-10-18T19:30:00Z",
        "domainId": "id_8h2k4q",
        "errorCode": "string",
        "id": "id_8h2k4q",
        "kind": "string",
        "lane": "string",
        "nextAt": "2026-10-18T19:30:00Z",
        "phase": "string",
        "predecessor": "string",
        "processed": 0,
        "resource": "string",
        "revision": 0,
        "settingsRevision": 0,
        "state": "string",
        "total": 0,
        "trigger": "string",
        "updatedAt": "2026-10-18T19:30:00Z"
      }
    ],
    "nextCursor": "eyJvIjoyMH0"
  },
  "scope": {
    "serverId": "id_8h2k4q",
    "viewerFence": "string"
  }
}
Schema
  • dataobjectrequired
    • itemsarray of objectrequired
      • actionsarray of stringrequired
      • attemptintegerrequired
      • createdAtstringrequired

        RFC 3339 UTC instant; empty when absent.

      • domainIdstring
      • errorCodestring
      • idstringrequired
      • kindstringrequired
      • lanestringrequired
      • nextAtstringrequired

        RFC 3339 UTC instant; empty when absent.

      • phasestringrequired
      • predecessorstring
      • processedinteger
      • resourcestringrequired
      • revisionintegerrequired
      • settingsRevisionintegerrequired
      • statestringrequired
      • totalinteger
      • triggerstringrequired
      • updatedAtstringrequired

        RFC 3339 UTC instant; empty when absent.

    • nextCursorstringrequired
  • scopeobjectrequired
    • serverIdstringrequired
    • viewerFencestringrequired

defaultRequest refused or unavailableapplication/json

Example
{
  "error": {
    "code": "string",
    "message": "string"
  }
}
Schema
  • errorobjectrequired
    • codestringrequired
    • messagestringrequired

Error codesinvalid_requestunauthorizednot_permittednot_foundinternaldatabase_busy

Example request

curl -X GET "http://127.0.0.1:32500/v1/admin/console/jobs" \
  -H "Authorization: Bearer $PORTICO_API_KEY"
POST/v1/admin/console/jobsRead or update the selected projectionadmin
Audience
Integrations · Native API
Authorization
API key or personal access token with the admin scope, or a signed-in session
OpenAPI operation ID
post_admin_console_jobs
Max body
1 MiB

Request body application/json · required

Example
{
  "idempotencyKey": "string",
  "kind": "string",
  "resource": "string"
}
Schema
  • idempotencyKeystringrequired
  • kindstringrequired
  • resourcestringrequired

Responses

200Successapplication/json

Example
{
  "data": {
    "actions": [
      "string"
    ],
    "attempt": 0,
    "createdAt": "2026-10-18T19:30:00Z",
    "domainId": "id_8h2k4q",
    "errorCode": "string",
    "id": "id_8h2k4q",
    "kind": "string",
    "lane": "string",
    "nextAt": "2026-10-18T19:30:00Z",
    "phase": "string",
    "predecessor": "string",
    "processed": 0,
    "resource": "string",
    "revision": 0,
    "settingsRevision": 0,
    "state": "string",
    "total": 0,
    "trigger": "string",
    "updatedAt": "2026-10-18T19:30:00Z"
  },
  "scope": {
    "serverId": "id_8h2k4q",
    "viewerFence": "string"
  }
}
Schema
  • dataobjectrequired
    • actionsarray of stringrequired
    • attemptintegerrequired
    • createdAtstringrequired

      RFC 3339 UTC instant; empty when absent.

    • domainIdstring
    • errorCodestring
    • idstringrequired
    • kindstringrequired
    • lanestringrequired
    • nextAtstringrequired

      RFC 3339 UTC instant; empty when absent.

    • phasestringrequired
    • predecessorstring
    • processedinteger
    • resourcestringrequired
    • revisionintegerrequired
    • settingsRevisionintegerrequired
    • statestringrequired
    • totalinteger
    • triggerstringrequired
    • updatedAtstringrequired

      RFC 3339 UTC instant; empty when absent.

  • scopeobjectrequired
    • serverIdstringrequired
    • viewerFencestringrequired

defaultRequest refused or unavailableapplication/json

Example
{
  "error": {
    "code": "string",
    "message": "string"
  }
}
Schema
  • errorobjectrequired
    • codestringrequired
    • messagestringrequired

Error codesinvalid_requestunauthorizednot_permittednot_foundinternaldatabase_busywriter_capacity

Example request

curl -X POST "http://127.0.0.1:32500/v1/admin/console/jobs" \
  -H "Authorization: Bearer $PORTICO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"idempotencyKey":"string","kind":"string","resource":"string"}'
POST/v1/admin/console/jobs/{id}/{action}Read or update the selected projectionadmin
Audience
Integrations · Native API
Authorization
API key or personal access token with the admin scope, or a signed-in session
OpenAPI operation ID
post_admin_console_jobs_id_action
Max body
1 MiB

Parameters

NameInTypeDescription
idrequiredpathstring
actionrequiredpathstring

Request body application/json · required

Example
{
  "expectedRevision": 0,
  "idempotencyKey": "string"
}
Schema
  • expectedRevisionintegerrequired
  • idempotencyKeystringrequired

Responses

200Successapplication/json

Example
{
  "data": {
    "actions": [
      "string"
    ],
    "attempt": 0,
    "createdAt": "2026-10-18T19:30:00Z",
    "domainId": "id_8h2k4q",
    "errorCode": "string",
    "id": "id_8h2k4q",
    "kind": "string",
    "lane": "string",
    "nextAt": "2026-10-18T19:30:00Z",
    "phase": "string",
    "predecessor": "string",
    "processed": 0,
    "resource": "string",
    "revision": 0,
    "settingsRevision": 0,
    "state": "string",
    "total": 0,
    "trigger": "string",
    "updatedAt": "2026-10-18T19:30:00Z"
  },
  "scope": {
    "serverId": "id_8h2k4q",
    "viewerFence": "string"
  }
}
Schema
  • dataobjectrequired
    • actionsarray of stringrequired
    • attemptintegerrequired
    • createdAtstringrequired

      RFC 3339 UTC instant; empty when absent.

    • domainIdstring
    • errorCodestring
    • idstringrequired
    • kindstringrequired
    • lanestringrequired
    • nextAtstringrequired

      RFC 3339 UTC instant; empty when absent.

    • phasestringrequired
    • predecessorstring
    • processedinteger
    • resourcestringrequired
    • revisionintegerrequired
    • settingsRevisionintegerrequired
    • statestringrequired
    • totalinteger
    • triggerstringrequired
    • updatedAtstringrequired

      RFC 3339 UTC instant; empty when absent.

  • scopeobjectrequired
    • serverIdstringrequired
    • viewerFencestringrequired

defaultRequest refused or unavailableapplication/json

Example
{
  "error": {
    "code": "string",
    "message": "string"
  }
}
Schema
  • errorobjectrequired
    • codestringrequired
    • messagestringrequired

Error codesinvalid_requestunauthorizednot_permittednot_foundinternaldatabase_busywriter_capacity

Example request

curl -X POST "http://127.0.0.1:32500/v1/admin/console/jobs/{id}/{action}" \
  -H "Authorization: Bearer $PORTICO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"expectedRevision":0,"idempotencyKey":"string"}'
GET/v1/admin/console/panels/{panel}Read or update the selected projectionadmin
Audience
Clients · Native API
Authorization
API key or personal access token with the admin scope, or a signed-in session
OpenAPI operation ID
get_admin_console_panels_panel

Parameters

NameInTypeDescription
panelrequiredpathstring

Responses

200Successapplication/json

Example
{
  "data": {
    "facts": {
      "key": {
        "reason": "string",
        "state": "string",
        "unit": "string",
        "value": null
      }
    },
    "freshUntil": "string",
    "name": "Fargo",
    "observedAt": "2026-10-18T19:30:00Z"
  },
  "scope": {
    "serverId": "id_8h2k4q",
    "viewerFence": "string"
  }
}
Schema
  • dataobjectrequired
    • factsobjectrequired
      • reasonstring
      • statestringrequired
      • unitstring
      • valueanyrequired
    • freshUntilstringrequired

      RFC 3339 UTC instant; empty when absent.

    • namestringrequired
    • observedAtstringrequired

      RFC 3339 UTC instant; empty when absent.

  • scopeobjectrequired
    • serverIdstringrequired
    • viewerFencestringrequired

defaultRequest refused or unavailableapplication/json

Example
{
  "error": {
    "code": "string",
    "message": "string"
  }
}
Schema
  • errorobjectrequired
    • codestringrequired
    • messagestringrequired

Error codesinvalid_requestunauthorizednot_permittednot_foundinternaldatabase_busy

Example request

curl -X GET "http://127.0.0.1:32500/v1/admin/console/panels/{panel}" \
  -H "Authorization: Bearer $PORTICO_API_KEY"
GET/v1/admin/console/schedulesRead or update the selected projectionadmin
Audience
Clients · Native API
Authorization
API key or personal access token with the admin scope, or a signed-in session
OpenAPI operation ID
get_admin_console_schedules

Responses

200Successapplication/json

Example
{
  "data": [
    {
      "catchUp": true,
      "createdAt": "2026-10-18T19:30:00Z",
      "enabled": true,
      "id": "id_8h2k4q",
      "kind": "string",
      "lastSlot": "string",
      "resource": "string",
      "revision": 0,
      "startMinute": 0,
      "timezone": "2026-10-18T19:30:00Z",
      "windowMinutes": 0
    }
  ],
  "scope": {
    "serverId": "id_8h2k4q",
    "viewerFence": "string"
  }
}
Schema
  • dataarray of objectrequired
    • catchUpbooleanrequired
    • createdAtstringrequired

      RFC 3339 UTC instant; empty when absent.

    • enabledbooleanrequired
    • idstringrequired
    • kindstringrequired
    • lastSlotstringrequired
    • resourcestringrequired
    • revisionintegerrequired
    • startMinuteintegerrequired
    • timezonestringrequired
    • windowMinutesintegerrequired
  • scopeobjectrequired
    • serverIdstringrequired
    • viewerFencestringrequired

defaultRequest refused or unavailableapplication/json

Example
{
  "error": {
    "code": "string",
    "message": "string"
  }
}
Schema
  • errorobjectrequired
    • codestringrequired
    • messagestringrequired

Error codesinvalid_requestunauthorizednot_permittednot_foundinternaldatabase_busy

Example request

curl -X GET "http://127.0.0.1:32500/v1/admin/console/schedules" \
  -H "Authorization: Bearer $PORTICO_API_KEY"
PUT/v1/admin/console/schedulesRead or update the selected projectionadmin
Audience
Clients · Native API
Authorization
API key or personal access token with the admin scope, or a signed-in session
OpenAPI operation ID
put_admin_console_schedules
Max body
1 MiB

Request body application/json · required

Example
{
  "expectedRevision": 0,
  "idempotencyKey": "string",
  "value": {
    "catchUp": true,
    "createdAt": "2026-10-18T19:30:00Z",
    "enabled": true,
    "id": "id_8h2k4q",
    "kind": "string",
    "lastSlot": "string",
    "resource": "string",
    "revision": 0,
    "startMinute": 0,
    "timezone": "2026-10-18T19:30:00Z",
    "windowMinutes": 0
  }
}
Schema
  • expectedRevisionintegerrequired
  • idempotencyKeystringrequired
  • valueobjectrequired
    • catchUpbooleanrequired
    • createdAtstringrequired

      RFC 3339 UTC instant; empty when absent.

    • enabledbooleanrequired
    • idstringrequired
    • kindstringrequired
    • lastSlotstringrequired
    • resourcestringrequired
    • revisionintegerrequired
    • startMinuteintegerrequired
    • timezonestringrequired
    • windowMinutesintegerrequired

Responses

200Successapplication/json

Example
{
  "data": {
    "catchUp": true,
    "createdAt": "2026-10-18T19:30:00Z",
    "enabled": true,
    "id": "id_8h2k4q",
    "kind": "string",
    "lastSlot": "string",
    "resource": "string",
    "revision": 0,
    "startMinute": 0,
    "timezone": "2026-10-18T19:30:00Z",
    "windowMinutes": 0
  },
  "scope": {
    "serverId": "id_8h2k4q",
    "viewerFence": "string"
  }
}
Schema
  • dataobjectrequired
    • catchUpbooleanrequired
    • createdAtstringrequired

      RFC 3339 UTC instant; empty when absent.

    • enabledbooleanrequired
    • idstringrequired
    • kindstringrequired
    • lastSlotstringrequired
    • resourcestringrequired
    • revisionintegerrequired
    • startMinuteintegerrequired
    • timezonestringrequired
    • windowMinutesintegerrequired
  • scopeobjectrequired
    • serverIdstringrequired
    • viewerFencestringrequired

defaultRequest refused or unavailableapplication/json

Example
{
  "error": {
    "code": "string",
    "message": "string"
  }
}
Schema
  • errorobjectrequired
    • codestringrequired
    • messagestringrequired

Error codesinvalid_requestunauthorizednot_permittednot_foundinternaldatabase_busywriter_capacity

Example request

curl -X PUT "http://127.0.0.1:32500/v1/admin/console/schedules" \
  -H "Authorization: Bearer $PORTICO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "expectedRevision": 0,
  "idempotencyKey": "string",
  "value": {
    "catchUp": true,
    "createdAt": "2026-10-18T19:30:00Z",
    "enabled": true,
    "id": "id_8h2k4q",
    "kind": "string",
    "lastSlot": "string",
    "resource": "string",
    "revision": 0,
    "startMinute": 0,
    "timezone": "2026-10-18T19:30:00Z",
    "windowMinutes": 0
  }
}'
GET/v1/admin/console/settingsRead requested and effective owner settingsadmin
Audience
Clients · Native API
Authorization
API key or personal access token with the admin scope, or a signed-in session
OpenAPI operation ID
get_console_settings

Responses

200Successapplication/json

Example
{
  "data": {
    "activeRevision": 0,
    "digest": "string",
    "effective": {
      "accessUrls": [
        "https://example.com/…"
      ],
      "advertiseUrl": "https://example.com/…",
      "advertisedInterface": "string",
      "analysisStageStorageMiB": 0,
      "analysisStorageGiB": 0,
      "apiRequestsPerMinute": 0,
      "connectionLimit": 0,
      "conversionMode": "string",
      "customCertificateDomain": "string",
      "customCertificateKeyPath": "string",
      "customCertificatePath": "string",
      "diagnosticDays": 0,
      "directStreamRemux": true,
      "dlnaEnabled": true,
      "downloadMaxQuality": "string",
      "ffmpegPath": "string",
      "hardwareBackend": "string",
      "hardwareDecode": true,
      "hardwareDevice": "string",
      "hardwareSelection": "string",
      "hdrToneMapping": true,
      "hdrToneMappingAlgorithm": "string",
      "home.communityActivityEnabled": true,
      "integrations.compatibilityEnabled": true,
      "jobDays": 0,
      "lanDiscoveryEnabled": true,
      "lanNetworks": [
        "string"
      ],
      "library.missingTitles": "Fargo",
      "library.missingTitlesDays": 0,
      "library.segmentDetection": "string",
      "logDetailMinutes": 15,
      "logLevel": "string",
      "logRetention": [
        {
          "category": "string",
          "days": 0
        }
      ],
      "maxBackgroundSessions": 0,
      "maxConcurrentSessions": 0,
      "maxHardwareSessions": 0,
      "maxSoftwareSessions": 0,
      "memoryCap": "string",
      "musicAwayQuality": "string",
      "name": "Fargo",
      "notificationDays": 0,
      "outputFormat": "2026-10-18T19:30:00Z",
      "ownAddressEnabled": true,
      "pausedSessionTimeoutMinutes": 0,
      "people.invitation_days": 1,
      "people.invitation_role": "member",
      "perAccountCap": 0,
      "planningPolicy": "string",
      "playHistoryDays": 0,
      "playedRetentionMs": 1800000,
      "recommendations.titleDataset": true,
      "remoteAccess": "string",
      "remoteBitrateLimitKbps": 0,
      "remoteSecurity": "string",
      "remoteSignInPolicy": "string",
      "secureConnections": "string",
      "segments.animeMode": "server",
      "segments.automaticConfidencePercent": 70,
      "segments.creditsWindow": "usual",
      "segments.filmCreditsWindow": "usual",
      "segments.introWindow": "usual",
      "segments.movieMode": "server",
      "segments.shortestEpisode": 1,
      "segments.shortestFilm": 5,
      "segments.tvMode": "server",
      "segments.useChapterNames": true,
      "segments.viewerConfidencePercent": 30,
      "serverCap": 0,
      "sessionStorageMiB": 0,
      "subtitleFileLimitMiB": 0,
      "subtitleTrackLimit": 0,
      "temporaryDirectory": "string",
      "throttleBufferMs": 1800000,
      "transcodeLocation": "string",
      "trustedProxies": [
        "string"
      ],
      "updates.feedUrl": "https://example.com/…",
      "updates.releaseChannel": "string",
      "uploadCapacityKbps": 0,
      "x264Preset": "string"
    },
    "ffmpegValidation": {
      "checkedAt": "2026-10-18T19:30:00Z",
      "inUse": true,
      "missingFeatures": [
        "string"
      ],
      "path": "string",
      "reasonCode": "string",
      "state": "string"
    },
    "registryRevision": "r12",
    "requested": {
      "accessUrls": [
        "https://example.com/…"
      ],
      "advertiseUrl": "https://example.com/…",
      "advertisedInterface": "string",
      "analysisStageStorageMiB": 0,
      "analysisStorageGiB": 0,
      "apiRequestsPerMinute": 0,
      "connectionLimit": 0,
      "conversionMode": "string",
      "customCertificateDomain": "string",
      "customCertificateKeyPath": "string",
      "customCertificatePath": "string",
      "diagnosticDays": 0,
      "directStreamRemux": true,
      "dlnaEnabled": true,
      "downloadMaxQuality": "string",
      "ffmpegPath": "string",
      "hardwareBackend": "string",
      "hardwareDecode": true,
      "hardwareDevice": "string",
      "hardwareSelection": "string",
      "hdrToneMapping": true,
      "hdrToneMappingAlgorithm": "string",
      "home.communityActivityEnabled": true,
      "integrations.compatibilityEnabled": true,
      "jobDays": 0,
      "lanDiscoveryEnabled": true,
      "lanNetworks": [
        "string"
      ],
      "library.missingTitles": "Fargo",
      "library.missingTitlesDays": 0,
      "library.segmentDetection": "string",
      "logDetailMinutes": 15,
      "logLevel": "string",
      "logRetention": [
        {
          "category": "string",
          "days": 0
        }
      ],
      "maxBackgroundSessions": 0,
      "maxConcurrentSessions": 0,
      "maxHardwareSessions": 0,
      "maxSoftwareSessions": 0,
      "memoryCap": "string",
      "musicAwayQuality": "string",
      "name": "Fargo",
      "notificationDays": 0,
      "outputFormat": "2026-10-18T19:30:00Z",
      "ownAddressEnabled": true,
      "pausedSessionTimeoutMinutes": 0,
      "people.invitation_days": 1,
      "people.invitation_role": "member",
      "perAccountCap": 0,
      "planningPolicy": "string",
      "playHistoryDays": 0,
      "playedRetentionMs": 1800000,
      "recommendations.titleDataset": true,
      "remoteAccess": "string",
      "remoteBitrateLimitKbps": 0,
      "remoteSecurity": "string",
      "remoteSignInPolicy": "string",
      "secureConnections": "string",
      "segments.animeMode": "server",
      "segments.automaticConfidencePercent": 70,
      "segments.creditsWindow": "usual",
      "segments.filmCreditsWindow": "usual",
      "segments.introWindow": "usual",
      "segments.movieMode": "server",
      "segments.shortestEpisode": 1,
      "segments.shortestFilm": 5,
      "segments.tvMode": "server",
      "segments.useChapterNames": true,
      "segments.viewerConfidencePercent": 30,
      "serverCap": 0,
      "sessionStorageMiB": 0,
      "subtitleFileLimitMiB": 0,
      "subtitleTrackLimit": 0,
      "temporaryDirectory": "string",
      "throttleBufferMs": 1800000,
      "transcodeLocation": "string",
      "trustedProxies": [
        "string"
      ],
      "updates.feedUrl": "https://example.com/…",
      "updates.releaseChannel": "string",
      "uploadCapacityKbps": 0,
      "x264Preset": "string"
    },
    "restartFields": [
      "string"
    ],
    "revision": 0
  },
  "scope": {
    "serverId": "id_8h2k4q",
    "viewerFence": "string"
  }
}
Schema
  • dataobjectrequired
    • activeRevisionintegerrequired
    • digeststringrequired
    • effectiveobjectrequired
      • accessUrlsarray of stringrequired
      • advertiseUrlstringrequired
      • advertisedInterfacestringrequired
      • analysisStageStorageMiBintegerrequired
      • analysisStorageGiBintegerrequired
      • apiRequestsPerMinuteintegerrequired
      • connectionLimitintegerrequired
      • conversionModestringrequired
      • customCertificateDomainstringrequired
      • customCertificateKeyPathstringrequired
      • customCertificatePathstringrequired
      • diagnosticDaysintegerrequired
      • directStreamRemuxbooleanrequired
      • dlnaEnabledbooleanrequired
      • downloadMaxQualitystringrequired
      • ffmpegPathstringrequired
      • hardwareBackendstringrequired
      • hardwareDecodebooleanrequired
      • hardwareDevicestringrequired
      • hardwareSelectionstringrequired
      • hdrToneMappingbooleanrequired
      • hdrToneMappingAlgorithmstringrequired
      • home.communityActivityEnabledbooleanrequired
      • integrations.compatibilityEnabledbooleanrequired
      • jobDaysintegerrequired
      • lanDiscoveryEnabledbooleanrequired
      • lanNetworksarray of stringrequired
      • library.missingTitlesstringrequired
      • library.missingTitlesDaysintegerrequired
      • library.segmentDetectionstringrequired
      • logDetailMinutesintegerone of 15, 30, 60, 120, 240
      • logLevelstringrequired
      • logRetentionarray of objectrequired
        • categorystringrequired
        • daysintegerrequired
      • maxBackgroundSessionsintegerrequired
      • maxConcurrentSessionsintegerrequired
      • maxHardwareSessionsintegerrequired
      • maxSoftwareSessionsintegerrequired
      • memoryCapstringrequired
      • musicAwayQualitystringrequired
      • namestringrequired
      • notificationDaysintegerrequired
      • outputFormatstringrequired
      • ownAddressEnabledbooleanrequired
      • pausedSessionTimeoutMinutesintegerrequired
      • people.invitation_daysintegerone of 1, 3, 7, 301–30
      • people.invitation_rolestringone of "member", "administrator"
      • perAccountCapinteger | any | nullrequired
      • planningPolicystringrequired
      • playHistoryDaysintegerrequired
      • playedRetentionMsintegerrequired
      • recommendations.titleDatasetbooleanrequired
      • remoteAccessstringrequired
      • remoteBitrateLimitKbpsintegerrequired
      • remoteSecuritystringrequired
      • remoteSignInPolicystringrequired
      • secureConnectionsstringrequired
      • segments.animeModestringone of "server", "standard", "thorough", "off"
      • segments.automaticConfidencePercentintegerone of 70, 85, 95
      • segments.creditsWindowstringone of "usual", "long"
      • segments.filmCreditsWindowstringone of "usual", "long"
      • segments.introWindowstringone of "usual", "long"
      • segments.movieModestringone of "server", "standard", "thorough", "off"
      • segments.shortestEpisodeintegerone of 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30
      • segments.shortestFilmintegerone of 5, 10, 15, 20, 25, 30, 35, 40, 45, 50, 55, 60
      • segments.tvModestringone of "server", "standard", "thorough", "off"
      • segments.useChapterNamesboolean
      • segments.viewerConfidencePercentintegerone of 30, 50, 70
      • serverCapinteger | any | nullrequired
      • sessionStorageMiBintegerrequired
      • subtitleFileLimitMiBintegerrequired
      • subtitleTrackLimitintegerrequired
      • temporaryDirectorystringrequired
      • throttleBufferMsintegerrequired
      • transcodeLocationstringrequired
      • trustedProxiesarray of stringrequired
      • updates.feedUrlstringrequired
      • updates.releaseChannelstringrequired
      • uploadCapacityKbpsintegerrequired
      • x264Presetstringrequired
    • ffmpegValidationobject
      • checkedAtstringrequired
      • inUsebooleanrequired
      • missingFeaturesarray of stringrequired
      • pathstringrequired
      • reasonCodestring
      • statestringrequired
    • registryRevisionstringrequired
    • requestedobjectrequired
      • accessUrlsarray of stringrequired
      • advertiseUrlstringrequired
      • advertisedInterfacestringrequired
      • analysisStageStorageMiBintegerrequired
      • analysisStorageGiBintegerrequired
      • apiRequestsPerMinuteintegerrequired
      • connectionLimitintegerrequired
      • conversionModestringrequired
      • customCertificateDomainstringrequired
      • customCertificateKeyPathstringrequired
      • customCertificatePathstringrequired
      • diagnosticDaysintegerrequired
      • directStreamRemuxbooleanrequired
      • dlnaEnabledbooleanrequired
      • downloadMaxQualitystringrequired
      • ffmpegPathstringrequired
      • hardwareBackendstringrequired
      • hardwareDecodebooleanrequired
      • hardwareDevicestringrequired
      • hardwareSelectionstringrequired
      • hdrToneMappingbooleanrequired
      • hdrToneMappingAlgorithmstringrequired
      • home.communityActivityEnabledbooleanrequired
      • integrations.compatibilityEnabledbooleanrequired
      • jobDaysintegerrequired
      • lanDiscoveryEnabledbooleanrequired
      • lanNetworksarray of stringrequired
      • library.missingTitlesstringrequired
      • library.missingTitlesDaysintegerrequired
      • library.segmentDetectionstringrequired
      • logDetailMinutesintegerone of 15, 30, 60, 120, 240
      • logLevelstringrequired
      • logRetentionarray of objectrequired
        • categorystringrequired
        • daysintegerrequired
      • maxBackgroundSessionsintegerrequired
      • maxConcurrentSessionsintegerrequired
      • maxHardwareSessionsintegerrequired
      • maxSoftwareSessionsintegerrequired
      • memoryCapstringrequired
      • musicAwayQualitystringrequired
      • namestringrequired
      • notificationDaysintegerrequired
      • outputFormatstringrequired
      • ownAddressEnabledbooleanrequired
      • pausedSessionTimeoutMinutesintegerrequired
      • people.invitation_daysintegerone of 1, 3, 7, 301–30
      • people.invitation_rolestringone of "member", "administrator"
      • perAccountCapinteger | any | nullrequired
      • planningPolicystringrequired
      • playHistoryDaysintegerrequired
      • playedRetentionMsintegerrequired
      • recommendations.titleDatasetbooleanrequired
      • remoteAccessstringrequired
      • remoteBitrateLimitKbpsintegerrequired
      • remoteSecuritystringrequired
      • remoteSignInPolicystringrequired
      • secureConnectionsstringrequired
      • segments.animeModestringone of "server", "standard", "thorough", "off"
      • segments.automaticConfidencePercentintegerone of 70, 85, 95
      • segments.creditsWindowstringone of "usual", "long"
      • segments.filmCreditsWindowstringone of "usual", "long"
      • segments.introWindowstringone of "usual", "long"
      • segments.movieModestringone of "server", "standard", "thorough", "off"
      • segments.shortestEpisodeintegerone of 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30
      • segments.shortestFilmintegerone of 5, 10, 15, 20, 25, 30, 35, 40, 45, 50, 55, 60
      • segments.tvModestringone of "server", "standard", "thorough", "off"
      • segments.useChapterNamesboolean
      • segments.viewerConfidencePercentintegerone of 30, 50, 70
      • serverCapinteger | any | nullrequired
      • sessionStorageMiBintegerrequired
      • subtitleFileLimitMiBintegerrequired
      • subtitleTrackLimitintegerrequired
      • temporaryDirectorystringrequired
      • throttleBufferMsintegerrequired
      • transcodeLocationstringrequired
      • trustedProxiesarray of stringrequired
      • updates.feedUrlstringrequired
      • updates.releaseChannelstringrequired
      • uploadCapacityKbpsintegerrequired
      • x264Presetstringrequired
    • restartFieldsarray of stringrequired
    • revisionintegerrequired
  • scopeobjectrequired
    • serverIdstringrequired
    • viewerFencestringrequired

defaultRequest refused or unavailableapplication/json

Example
{
  "error": {
    "code": "string",
    "message": "string"
  }
}
Schema
  • errorobjectrequired
    • codestringrequired
    • messagestringrequired

Error codesunauthorizednot_permittedinvalid_requestrevision_mismatchidempotency_key_reusedrate_limitedinternaldatabase_busy

Example request

curl -X GET "http://127.0.0.1:32500/v1/admin/console/settings" \
  -H "Authorization: Bearer $PORTICO_API_KEY"
PATCH/v1/admin/console/settingsSave a complete owner settings documentadmin
Audience
Clients · Native API
Authorization
API key or personal access token with the admin scope, or a signed-in session
OpenAPI operation ID
change_console_settings
Max body
64 KiB

Parameters

NameInTypeDescription
Idempotency-Keyheaderstring
Portico-Mutation-Rootheaderstring

Request body application/json · required

Example
{
  "expectedRevision": 0,
  "idempotencyKey": "string",
  "values": {
    "accessUrls": [
      "https://example.com/…"
    ],
    "advertiseUrl": "https://example.com/…",
    "advertisedInterface": "string",
    "analysisStageStorageMiB": 0,
    "analysisStorageGiB": 0,
    "apiRequestsPerMinute": 0,
    "connectionLimit": 0,
    "conversionMode": "string",
    "customCertificateDomain": "string",
    "customCertificateKeyPath": "string",
    "customCertificatePath": "string",
    "diagnosticDays": 0,
    "directStreamRemux": true,
    "dlnaEnabled": true,
    "downloadMaxQuality": "string",
    "ffmpegPath": "string",
    "hardwareBackend": "string",
    "hardwareDecode": true,
    "hardwareDevice": "string",
    "hardwareSelection": "string",
    "hdrToneMapping": true,
    "hdrToneMappingAlgorithm": "string",
    "home.communityActivityEnabled": true,
    "integrations.compatibilityEnabled": true,
    "jobDays": 0,
    "lanDiscoveryEnabled": true,
    "lanNetworks": [
      "string"
    ],
    "library.missingTitles": "Fargo",
    "library.missingTitlesDays": 0,
    "library.segmentDetection": "string",
    "logDetailMinutes": 15,
    "logLevel": "string",
    "logRetention": [
      {
        "category": "string",
        "days": 0
      }
    ],
    "maxBackgroundSessions": 0,
    "maxConcurrentSessions": 0,
    "maxHardwareSessions": 0,
    "maxSoftwareSessions": 0,
    "memoryCap": "string",
    "musicAwayQuality": "string",
    "name": "Fargo",
    "notificationDays": 0,
    "outputFormat": "2026-10-18T19:30:00Z",
    "ownAddressEnabled": true,
    "pausedSessionTimeoutMinutes": 0,
    "people.invitation_days": 1,
    "people.invitation_role": "member",
    "perAccountCap": 0,
    "planningPolicy": "string",
    "playHistoryDays": 0,
    "playedRetentionMs": 1800000,
    "recommendations.titleDataset": true,
    "remoteAccess": "string",
    "remoteBitrateLimitKbps": 0,
    "remoteSecurity": "string",
    "remoteSignInPolicy": "string",
    "secureConnections": "string",
    "segments.animeMode": "server",
    "segments.automaticConfidencePercent": 70,
    "segments.creditsWindow": "usual",
    "segments.filmCreditsWindow": "usual",
    "segments.introWindow": "usual",
    "segments.movieMode": "server",
    "segments.shortestEpisode": 1,
    "segments.shortestFilm": 5,
    "segments.tvMode": "server",
    "segments.useChapterNames": true,
    "segments.viewerConfidencePercent": 30,
    "serverCap": 0,
    "sessionStorageMiB": 0,
    "subtitleFileLimitMiB": 0,
    "subtitleTrackLimit": 0,
    "temporaryDirectory": "string",
    "throttleBufferMs": 1800000,
    "transcodeLocation": "string",
    "trustedProxies": [
      "string"
    ],
    "updates.feedUrl": "https://example.com/…",
    "updates.releaseChannel": "string",
    "uploadCapacityKbps": 0,
    "x264Preset": "string"
  }
}
Schema
  • expectedRevisionintegerrequired
  • idempotencyKeystringrequired
  • valuesobjectrequired
    • accessUrlsarray of stringrequired
    • advertiseUrlstringrequired
    • advertisedInterfacestringrequired
    • analysisStageStorageMiBintegerrequired
    • analysisStorageGiBintegerrequired
    • apiRequestsPerMinuteintegerrequired
    • connectionLimitintegerrequired
    • conversionModestringrequired
    • customCertificateDomainstringrequired
    • customCertificateKeyPathstringrequired
    • customCertificatePathstringrequired
    • diagnosticDaysintegerrequired
    • directStreamRemuxbooleanrequired
    • dlnaEnabledbooleanrequired
    • downloadMaxQualitystringrequired
    • ffmpegPathstringrequired
    • hardwareBackendstringrequired
    • hardwareDecodebooleanrequired
    • hardwareDevicestringrequired
    • hardwareSelectionstringrequired
    • hdrToneMappingbooleanrequired
    • hdrToneMappingAlgorithmstringrequired
    • home.communityActivityEnabledbooleanrequired
    • integrations.compatibilityEnabledbooleanrequired
    • jobDaysintegerrequired
    • lanDiscoveryEnabledbooleanrequired
    • lanNetworksarray of stringrequired
    • library.missingTitlesstringrequired
    • library.missingTitlesDaysintegerrequired
    • library.segmentDetectionstringrequired
    • logDetailMinutesintegerone of 15, 30, 60, 120, 240
    • logLevelstringrequired
    • logRetentionarray of objectrequired
      • categorystringrequired
      • daysintegerrequired
    • maxBackgroundSessionsintegerrequired
    • maxConcurrentSessionsintegerrequired
    • maxHardwareSessionsintegerrequired
    • maxSoftwareSessionsintegerrequired
    • memoryCapstringrequired
    • musicAwayQualitystringrequired
    • namestringrequired
    • notificationDaysintegerrequired
    • outputFormatstringrequired
    • ownAddressEnabledbooleanrequired
    • pausedSessionTimeoutMinutesintegerrequired
    • people.invitation_daysintegerone of 1, 3, 7, 301–30
    • people.invitation_rolestringone of "member", "administrator"
    • perAccountCapinteger | any | nullrequired
    • planningPolicystringrequired
    • playHistoryDaysintegerrequired
    • playedRetentionMsintegerrequired
    • recommendations.titleDatasetbooleanrequired
    • remoteAccessstringrequired
    • remoteBitrateLimitKbpsintegerrequired
    • remoteSecuritystringrequired
    • remoteSignInPolicystringrequired
    • secureConnectionsstringrequired
    • segments.animeModestringone of "server", "standard", "thorough", "off"
    • segments.automaticConfidencePercentintegerone of 70, 85, 95
    • segments.creditsWindowstringone of "usual", "long"
    • segments.filmCreditsWindowstringone of "usual", "long"
    • segments.introWindowstringone of "usual", "long"
    • segments.movieModestringone of "server", "standard", "thorough", "off"
    • segments.shortestEpisodeintegerone of 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30
    • segments.shortestFilmintegerone of 5, 10, 15, 20, 25, 30, 35, 40, 45, 50, 55, 60
    • segments.tvModestringone of "server", "standard", "thorough", "off"
    • segments.useChapterNamesboolean
    • segments.viewerConfidencePercentintegerone of 30, 50, 70
    • serverCapinteger | any | nullrequired
    • sessionStorageMiBintegerrequired
    • subtitleFileLimitMiBintegerrequired
    • subtitleTrackLimitintegerrequired
    • temporaryDirectorystringrequired
    • throttleBufferMsintegerrequired
    • transcodeLocationstringrequired
    • trustedProxiesarray of stringrequired
    • updates.feedUrlstringrequired
    • updates.releaseChannelstringrequired
    • uploadCapacityKbpsintegerrequired
    • x264Presetstringrequired

Responses

200Successapplication/json

Example
{
  "data": {
    "activeRevision": 0,
    "digest": "string",
    "effective": {
      "accessUrls": [
        "https://example.com/…"
      ],
      "advertiseUrl": "https://example.com/…",
      "advertisedInterface": "string",
      "analysisStageStorageMiB": 0,
      "analysisStorageGiB": 0,
      "apiRequestsPerMinute": 0,
      "connectionLimit": 0,
      "conversionMode": "string",
      "customCertificateDomain": "string",
      "customCertificateKeyPath": "string",
      "customCertificatePath": "string",
      "diagnosticDays": 0,
      "directStreamRemux": true,
      "dlnaEnabled": true,
      "downloadMaxQuality": "string",
      "ffmpegPath": "string",
      "hardwareBackend": "string",
      "hardwareDecode": true,
      "hardwareDevice": "string",
      "hardwareSelection": "string",
      "hdrToneMapping": true,
      "hdrToneMappingAlgorithm": "string",
      "home.communityActivityEnabled": true,
      "integrations.compatibilityEnabled": true,
      "jobDays": 0,
      "lanDiscoveryEnabled": true,
      "lanNetworks": [
        "string"
      ],
      "library.missingTitles": "Fargo",
      "library.missingTitlesDays": 0,
      "library.segmentDetection": "string",
      "logDetailMinutes": 15,
      "logLevel": "string",
      "logRetention": [
        {
          "category": "string",
          "days": 0
        }
      ],
      "maxBackgroundSessions": 0,
      "maxConcurrentSessions": 0,
      "maxHardwareSessions": 0,
      "maxSoftwareSessions": 0,
      "memoryCap": "string",
      "musicAwayQuality": "string",
      "name": "Fargo",
      "notificationDays": 0,
      "outputFormat": "2026-10-18T19:30:00Z",
      "ownAddressEnabled": true,
      "pausedSessionTimeoutMinutes": 0,
      "people.invitation_days": 1,
      "people.invitation_role": "member",
      "perAccountCap": 0,
      "planningPolicy": "string",
      "playHistoryDays": 0,
      "playedRetentionMs": 1800000,
      "recommendations.titleDataset": true,
      "remoteAccess": "string",
      "remoteBitrateLimitKbps": 0,
      "remoteSecurity": "string",
      "remoteSignInPolicy": "string",
      "secureConnections": "string",
      "segments.animeMode": "server",
      "segments.automaticConfidencePercent": 70,
      "segments.creditsWindow": "usual",
      "segments.filmCreditsWindow": "usual",
      "segments.introWindow": "usual",
      "segments.movieMode": "server",
      "segments.shortestEpisode": 1,
      "segments.shortestFilm": 5,
      "segments.tvMode": "server",
      "segments.useChapterNames": true,
      "segments.viewerConfidencePercent": 30,
      "serverCap": 0,
      "sessionStorageMiB": 0,
      "subtitleFileLimitMiB": 0,
      "subtitleTrackLimit": 0,
      "temporaryDirectory": "string",
      "throttleBufferMs": 1800000,
      "transcodeLocation": "string",
      "trustedProxies": [
        "string"
      ],
      "updates.feedUrl": "https://example.com/…",
      "updates.releaseChannel": "string",
      "uploadCapacityKbps": 0,
      "x264Preset": "string"
    },
    "ffmpegValidation": {
      "checkedAt": "2026-10-18T19:30:00Z",
      "inUse": true,
      "missingFeatures": [
        "string"
      ],
      "path": "string",
      "reasonCode": "string",
      "state": "string"
    },
    "registryRevision": "r12",
    "requested": {
      "accessUrls": [
        "https://example.com/…"
      ],
      "advertiseUrl": "https://example.com/…",
      "advertisedInterface": "string",
      "analysisStageStorageMiB": 0,
      "analysisStorageGiB": 0,
      "apiRequestsPerMinute": 0,
      "connectionLimit": 0,
      "conversionMode": "string",
      "customCertificateDomain": "string",
      "customCertificateKeyPath": "string",
      "customCertificatePath": "string",
      "diagnosticDays": 0,
      "directStreamRemux": true,
      "dlnaEnabled": true,
      "downloadMaxQuality": "string",
      "ffmpegPath": "string",
      "hardwareBackend": "string",
      "hardwareDecode": true,
      "hardwareDevice": "string",
      "hardwareSelection": "string",
      "hdrToneMapping": true,
      "hdrToneMappingAlgorithm": "string",
      "home.communityActivityEnabled": true,
      "integrations.compatibilityEnabled": true,
      "jobDays": 0,
      "lanDiscoveryEnabled": true,
      "lanNetworks": [
        "string"
      ],
      "library.missingTitles": "Fargo",
      "library.missingTitlesDays": 0,
      "library.segmentDetection": "string",
      "logDetailMinutes": 15,
      "logLevel": "string",
      "logRetention": [
        {
          "category": "string",
          "days": 0
        }
      ],
      "maxBackgroundSessions": 0,
      "maxConcurrentSessions": 0,
      "maxHardwareSessions": 0,
      "maxSoftwareSessions": 0,
      "memoryCap": "string",
      "musicAwayQuality": "string",
      "name": "Fargo",
      "notificationDays": 0,
      "outputFormat": "2026-10-18T19:30:00Z",
      "ownAddressEnabled": true,
      "pausedSessionTimeoutMinutes": 0,
      "people.invitation_days": 1,
      "people.invitation_role": "member",
      "perAccountCap": 0,
      "planningPolicy": "string",
      "playHistoryDays": 0,
      "playedRetentionMs": 1800000,
      "recommendations.titleDataset": true,
      "remoteAccess": "string",
      "remoteBitrateLimitKbps": 0,
      "remoteSecurity": "string",
      "remoteSignInPolicy": "string",
      "secureConnections": "string",
      "segments.animeMode": "server",
      "segments.automaticConfidencePercent": 70,
      "segments.creditsWindow": "usual",
      "segments.filmCreditsWindow": "usual",
      "segments.introWindow": "usual",
      "segments.movieMode": "server",
      "segments.shortestEpisode": 1,
      "segments.shortestFilm": 5,
      "segments.tvMode": "server",
      "segments.useChapterNames": true,
      "segments.viewerConfidencePercent": 30,
      "serverCap": 0,
      "sessionStorageMiB": 0,
      "subtitleFileLimitMiB": 0,
      "subtitleTrackLimit": 0,
      "temporaryDirectory": "string",
      "throttleBufferMs": 1800000,
      "transcodeLocation": "string",
      "trustedProxies": [
        "string"
      ],
      "updates.feedUrl": "https://example.com/…",
      "updates.releaseChannel": "string",
      "uploadCapacityKbps": 0,
      "x264Preset": "string"
    },
    "restartFields": [
      "string"
    ],
    "revision": 0
  },
  "scope": {
    "serverId": "id_8h2k4q",
    "viewerFence": "string"
  }
}
Schema
  • dataobjectrequired
    • activeRevisionintegerrequired
    • digeststringrequired
    • effectiveobjectrequired
      • accessUrlsarray of stringrequired
      • advertiseUrlstringrequired
      • advertisedInterfacestringrequired
      • analysisStageStorageMiBintegerrequired
      • analysisStorageGiBintegerrequired
      • apiRequestsPerMinuteintegerrequired
      • connectionLimitintegerrequired
      • conversionModestringrequired
      • customCertificateDomainstringrequired
      • customCertificateKeyPathstringrequired
      • customCertificatePathstringrequired
      • diagnosticDaysintegerrequired
      • directStreamRemuxbooleanrequired
      • dlnaEnabledbooleanrequired
      • downloadMaxQualitystringrequired
      • ffmpegPathstringrequired
      • hardwareBackendstringrequired
      • hardwareDecodebooleanrequired
      • hardwareDevicestringrequired
      • hardwareSelectionstringrequired
      • hdrToneMappingbooleanrequired
      • hdrToneMappingAlgorithmstringrequired
      • home.communityActivityEnabledbooleanrequired
      • integrations.compatibilityEnabledbooleanrequired
      • jobDaysintegerrequired
      • lanDiscoveryEnabledbooleanrequired
      • lanNetworksarray of stringrequired
      • library.missingTitlesstringrequired
      • library.missingTitlesDaysintegerrequired
      • library.segmentDetectionstringrequired
      • logDetailMinutesintegerone of 15, 30, 60, 120, 240
      • logLevelstringrequired
      • logRetentionarray of objectrequired
        • categorystringrequired
        • daysintegerrequired
      • maxBackgroundSessionsintegerrequired
      • maxConcurrentSessionsintegerrequired
      • maxHardwareSessionsintegerrequired
      • maxSoftwareSessionsintegerrequired
      • memoryCapstringrequired
      • musicAwayQualitystringrequired
      • namestringrequired
      • notificationDaysintegerrequired
      • outputFormatstringrequired
      • ownAddressEnabledbooleanrequired
      • pausedSessionTimeoutMinutesintegerrequired
      • people.invitation_daysintegerone of 1, 3, 7, 301–30
      • people.invitation_rolestringone of "member", "administrator"
      • perAccountCapinteger | any | nullrequired
      • planningPolicystringrequired
      • playHistoryDaysintegerrequired
      • playedRetentionMsintegerrequired
      • recommendations.titleDatasetbooleanrequired
      • remoteAccessstringrequired
      • remoteBitrateLimitKbpsintegerrequired
      • remoteSecuritystringrequired
      • remoteSignInPolicystringrequired
      • secureConnectionsstringrequired
      • segments.animeModestringone of "server", "standard", "thorough", "off"
      • segments.automaticConfidencePercentintegerone of 70, 85, 95
      • segments.creditsWindowstringone of "usual", "long"
      • segments.filmCreditsWindowstringone of "usual", "long"
      • segments.introWindowstringone of "usual", "long"
      • segments.movieModestringone of "server", "standard", "thorough", "off"
      • segments.shortestEpisodeintegerone of 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30
      • segments.shortestFilmintegerone of 5, 10, 15, 20, 25, 30, 35, 40, 45, 50, 55, 60
      • segments.tvModestringone of "server", "standard", "thorough", "off"
      • segments.useChapterNamesboolean
      • segments.viewerConfidencePercentintegerone of 30, 50, 70
      • serverCapinteger | any | nullrequired
      • sessionStorageMiBintegerrequired
      • subtitleFileLimitMiBintegerrequired
      • subtitleTrackLimitintegerrequired
      • temporaryDirectorystringrequired
      • throttleBufferMsintegerrequired
      • transcodeLocationstringrequired
      • trustedProxiesarray of stringrequired
      • updates.feedUrlstringrequired
      • updates.releaseChannelstringrequired
      • uploadCapacityKbpsintegerrequired
      • x264Presetstringrequired
    • ffmpegValidationobject
      • checkedAtstringrequired
      • inUsebooleanrequired
      • missingFeaturesarray of stringrequired
      • pathstringrequired
      • reasonCodestring
      • statestringrequired
    • registryRevisionstringrequired
    • requestedobjectrequired
      • accessUrlsarray of stringrequired
      • advertiseUrlstringrequired
      • advertisedInterfacestringrequired
      • analysisStageStorageMiBintegerrequired
      • analysisStorageGiBintegerrequired
      • apiRequestsPerMinuteintegerrequired
      • connectionLimitintegerrequired
      • conversionModestringrequired
      • customCertificateDomainstringrequired
      • customCertificateKeyPathstringrequired
      • customCertificatePathstringrequired
      • diagnosticDaysintegerrequired
      • directStreamRemuxbooleanrequired
      • dlnaEnabledbooleanrequired
      • downloadMaxQualitystringrequired
      • ffmpegPathstringrequired
      • hardwareBackendstringrequired
      • hardwareDecodebooleanrequired
      • hardwareDevicestringrequired
      • hardwareSelectionstringrequired
      • hdrToneMappingbooleanrequired
      • hdrToneMappingAlgorithmstringrequired
      • home.communityActivityEnabledbooleanrequired
      • integrations.compatibilityEnabledbooleanrequired
      • jobDaysintegerrequired
      • lanDiscoveryEnabledbooleanrequired
      • lanNetworksarray of stringrequired
      • library.missingTitlesstringrequired
      • library.missingTitlesDaysintegerrequired
      • library.segmentDetectionstringrequired
      • logDetailMinutesintegerone of 15, 30, 60, 120, 240
      • logLevelstringrequired
      • logRetentionarray of objectrequired
        • categorystringrequired
        • daysintegerrequired
      • maxBackgroundSessionsintegerrequired
      • maxConcurrentSessionsintegerrequired
      • maxHardwareSessionsintegerrequired
      • maxSoftwareSessionsintegerrequired
      • memoryCapstringrequired
      • musicAwayQualitystringrequired
      • namestringrequired
      • notificationDaysintegerrequired
      • outputFormatstringrequired
      • ownAddressEnabledbooleanrequired
      • pausedSessionTimeoutMinutesintegerrequired
      • people.invitation_daysintegerone of 1, 3, 7, 301–30
      • people.invitation_rolestringone of "member", "administrator"
      • perAccountCapinteger | any | nullrequired
      • planningPolicystringrequired
      • playHistoryDaysintegerrequired
      • playedRetentionMsintegerrequired
      • recommendations.titleDatasetbooleanrequired
      • remoteAccessstringrequired
      • remoteBitrateLimitKbpsintegerrequired
      • remoteSecuritystringrequired
      • remoteSignInPolicystringrequired
      • secureConnectionsstringrequired
      • segments.animeModestringone of "server", "standard", "thorough", "off"
      • segments.automaticConfidencePercentintegerone of 70, 85, 95
      • segments.creditsWindowstringone of "usual", "long"
      • segments.filmCreditsWindowstringone of "usual", "long"
      • segments.introWindowstringone of "usual", "long"
      • segments.movieModestringone of "server", "standard", "thorough", "off"
      • segments.shortestEpisodeintegerone of 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30
      • segments.shortestFilmintegerone of 5, 10, 15, 20, 25, 30, 35, 40, 45, 50, 55, 60
      • segments.tvModestringone of "server", "standard", "thorough", "off"
      • segments.useChapterNamesboolean
      • segments.viewerConfidencePercentintegerone of 30, 50, 70
      • serverCapinteger | any | nullrequired
      • sessionStorageMiBintegerrequired
      • subtitleFileLimitMiBintegerrequired
      • subtitleTrackLimitintegerrequired
      • temporaryDirectorystringrequired
      • throttleBufferMsintegerrequired
      • transcodeLocationstringrequired
      • trustedProxiesarray of stringrequired
      • updates.feedUrlstringrequired
      • updates.releaseChannelstringrequired
      • uploadCapacityKbpsintegerrequired
      • x264Presetstringrequired
    • restartFieldsarray of stringrequired
    • revisionintegerrequired
  • scopeobjectrequired
    • serverIdstringrequired
    • viewerFencestringrequired

defaultRequest refused or unavailableapplication/json

Example
{
  "error": {
    "code": "string",
    "message": "string"
  }
}
Schema
  • errorobjectrequired
    • codestringrequired
    • messagestringrequired

Error codesunauthorizednot_permittedinvalid_requestrevision_mismatchidempotency_key_reusedrate_limitedinternalrevision_requiredidempotency_conflictreceipt_expiredinvalid_mutation_keydatabase_busywriter_capacity

Example request

curl -X PATCH "http://127.0.0.1:32500/v1/admin/console/settings" \
  -H "Authorization: Bearer $PORTICO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "expectedRevision": 0,
  "idempotencyKey": "string",
  "values": {
    "accessUrls": [
      "https://example.com/…"
    ],
    "advertiseUrl": "https://example.com/…",
    "advertisedInterface": "string",
    "analysisStageStorageMiB": 0,
    "analysisStorageGiB": 0,
    "apiRequestsPerMinute": 0,
    "connectionLimit": 0,
    "conversionMode": "string",
    "customCertificateDomain": "string",
    "customCertificateKeyPath": "string",
    "customCertificatePath": "string",
    "diagnosticDays": 0,
    "directStreamRemux": true,
    "dlnaEnabled": true,
    "downloadMaxQuality": "string",
    "ffmpegPath": "string",
    "hardwareBackend": "string",
    "hardwareDecode": true,
    "hardwareDevice": "string",
    "hardwareSelection": "string",
    "hdrToneMapping": true,
    "hdrToneMappingAlgorithm": "string",
    "home.communityActivityEnabled": true,
    "integrations.compatibilityEnabled": true,
    "jobDays": 0,
    "lanDiscoveryEnabled": true,
    "lanNetworks": [
      "string"
    ],
    "library.missingTitles": "Fargo",
    "library.missingTitlesDays": 0,
    "library.segmentDetection": "string",
    "logDetailMinutes": 15,
    "logLevel": "string",
    "logRetention": [
      {
        "category": "string",
        "days": 0
      }
    ],
    "maxBackgroundSessions": 0,
    "maxConcurrentSessions": 0,
    "maxHardwareSessions": 0,
    "maxSoftwareSessions": 0,
    "memoryCap": "string",
    "musicAwayQuality": "string",
    "name": "Fargo",
    "notificationDays": 0,
    "outputFormat": "2026-10-18T19:30:00Z",
    "ownAddressEnabled": true,
    "pausedSessionTimeoutMinutes": 0,
    "people.invitation_days": 1,
    "people.invitation_role": "member",
    "perAccountCap": 0,
    "planningPolicy": "string",
    "playHistoryDays": 0,
    "playedRetentionMs": 1800000,
    "recommendations.titleDataset": true,
    "remoteAccess": "string",
    "remoteBitrateLimitKbps": 0,
    "remoteSecurity": "string",
    "remoteSignInPolicy": "string",
    "secureConnections": "string",
    "segments.animeMode": "server",
    "segments.automaticConfidencePercent": 70,
    "segments.creditsWindow": "usual",
    "segments.filmCreditsWindow": "usual",
    "segments.introWindow": "usual",
    "segments.movieMode": "server",
    "segments.shortestEpisode": 1,
    "segments.shortestFilm": 5,
    "segments.tvMode": "server",
    "segments.useChapterNames": true,
    "segments.viewerConfidencePercent": 30,
    "serverCap": 0,
    "sessionStorageMiB": 0,
    "subtitleFileLimitMiB": 0,
    "subtitleTrackLimit": 0,
    "temporaryDirectory": "string",
    "throttleBufferMs": 1800000,
    "transcodeLocation": "string",
    "trustedProxies": [
      "string"
    ],
    "updates.feedUrl": "https://example.com/…",
    "updates.releaseChannel": "string",
    "uploadCapacityKbps": 0,
    "x264Preset": "string"
  }
}'
GET/v1/admin/console/stream-optionsRead server console stream optionsadmin
Audience
Clients · Native API
Authorization
API key or personal access token with the admin scope, or a signed-in session
OpenAPI operation ID
get_admin_console_stream_options

Responses

200Successapplication/json

Example
{
  "data": {
    "libraries": [
      {
        "id": "id_8h2k4q",
        "label": "string"
      }
    ],
    "viewers": [
      {
        "id": "id_8h2k4q",
        "label": "string"
      }
    ]
  },
  "scope": {
    "serverId": "id_8h2k4q",
    "viewerFence": "string"
  }
}
Schema
  • dataobjectrequired
    • librariesarray of objectrequired
      • idstringrequired
      • labelstringrequired
    • viewersarray of objectrequired
      • idstringrequired
      • labelstringrequired
  • scopeobjectrequired
    • serverIdstringrequired
    • viewerFencestringrequired

defaultRequest refused or unavailableapplication/json

Example
{
  "error": {
    "code": "string",
    "message": "string"
  }
}
Schema
  • errorobjectrequired
    • codestringrequired
    • messagestringrequired

Error codesinvalid_requestunauthorizednot_permittednot_foundinternaldatabase_busy

Example request

curl -X GET "http://127.0.0.1:32500/v1/admin/console/stream-options" \
  -H "Authorization: Bearer $PORTICO_API_KEY"