API 경로

전문가

웹 앱이 쓰는 것과 같은 JSON API를 /api/v1 아래에서 직접 만든 스크립트로 호출합니다.

첫 호출 보내기

Settings > API > API keys(설정 > API > API 키)를 열고 필요한 권한 범위만 넣어 키를 만드세요. 키는 한 번만 표시되니 바로 복사하세요.
모든 호출에 X-Api-Key 헤더로 키를 보내세요. 주소에는 절대 넣지 마세요.
기본 주소를 호출하세요. URL base(기본 경로)가 /holyarrs이면 http://your-server:6262/holyarrs/api/v1입니다.

export HOLYARRS_KEY=...your key...
curl -H "X-Api-Key: $HOLYARRS_KEY" "http://your-server:6262/api/v1/health"

JSON 응답이 돌아옵니다. 오류는 HTTP 상태 코드와 함께 {"error": "plain words"} 형태로 옵니다. 비밀 값은 가려진 채로 돌아옵니다.

Settings > API에는 기본 주소, 권한 범위, 호출 예시, 그리고 모든 경로와 그 권한 범위가 나옵니다. 로그인한 상태에서는 /api/v1/openapi.json에서 OpenAPI 파일을 받을 수 있습니다.

권한 범위

권한 범위	허용하는 것
`health_read`	모니터링 도구용 상태 피드만.
`read`	읽기 경로. 상태 피드도 포함됩니다.
`write`	변경. 관리자 경로와 제어는 제외됩니다.
`admin`	사람, 초대, 요청 한도, API 키, 비밀번호와 2단계 인증, 로그인 설정, 복원.
`control`	파트 스위치, 단계, 연동된 앱, 재시작과 종료.
`all`	`read`, `write`, `admin`. `control`은 들어가지 않습니다.

Seerr, Bazarr 같은 앱은 이 API 대신 기존 앱 API를 쓰며, 키도 따로 있습니다.

문제가 생기면

증상	원인	해결
모든 호출에 401	키가 틀렸거나 삭제됨	키를 새로 만드세요.
403	키의 권한 범위가 그 경로에 미치지 않음	Settings > API에서 그 경로의 권한 범위를 확인하세요.
모든 호출에 404	URL base가 빠짐	`/api/v1` 앞에 넣으세요.

전문가용

메타데이터 서버 호출

HolyArrs는 이름, 사진, ID를 HolyArrs 메타데이터 서버에서 받아옵니다. HOLYARRS_METADATA_URL로 설치본이 다른 서버를 보게 할 수 있습니다. 서버 코드는 이 저장소에 없습니다.

등록. 설치본은 처음 조회할 때 본문 없이 POST /v1/installations를 호출합니다. 응답은 201이고 {"schema_version":1,"token":"hai_..."}가 함께 옵니다. 앱은 토큰을 암호화해 저장하고, 조회할 때마다 Authorization: Bearer <token>을 보냅니다. 등록은 한 번만 합니다. 401을 받은 뒤에는 다시 등록하지 않으므로, 취소된 설치본은 취소된 상태로 남습니다. 주소 그룹별 시간당 한도를 넘으면 응답은 Retry-After가 붙은 429 registration_limit입니다.

조회 (모두 GET)	경로
검색	`/v1/search?provider=tmdb&kind=movie&q=Example&page=1`
영화	`/v1/movies/tmdb/{id}`
시리즈	`/v1/shows/{tmdb or tvmaze}/{id}`
시즌	`/v1/shows/tmdb/{id}/seasons/{n}` (시즌 0은 스페셜)
음악	`/v1/music/musicbrainz/{artist, release-group, release or recording}/{id}`

모르는 매개변수나 중복된 매개변수는 거부됩니다. 한 제공자의 ID를 다른 제공자에 쓰는 일은 없습니다.

정상 응답에는 schema_version, source, source_id, fetched_at, expires_at, completeness, stale, data가 들어 있습니다. 요약에 든 HTML은 일반 텍스트로 다루세요.

상태 코드	뜻
400	잘못된 질의, 다시 시도하지 마세요
401	잘못되었거나 취소된 토큰, 다시 시도하지 마세요
404	그런 레코드 없음
429	호출이 너무 많음, `Retry-After`만큼 기다리세요
503	바쁨, 기다렸다가 한 번만 다시 시도하세요

경로 추가하기

경로는 각 모듈의 routes.go에 있고, 메서드, 경로, 권한과 함께 등록됩니다. 그래서 권한 검사 없는 경로는 존재할 수 없습니다. openapi.json은 경로에서 만들어지며, 둘이 어긋나면 테스트가 실패합니다. 한 번 릴리스된 경로와 필드 이름은 그대로 둡니다. 필드는 추가만 하고 이름은 바꾸지 마세요.

모든 경로

경로는 520개입니다. go run ./app/backend/tools/apidoc로 다시 생성하세요.

권한 열은 호출하는 쪽에 필요한 권한이며, 스냅샷에 고정된 그대로입니다. 용도 열은 경로 등록에 주석이 있는 경우에만 채워집니다.

account

메서드	경로	권한	용도
PUT	`/api/v1/account/avatar`	self
DELETE	`/api/v1/account/avatar`	self

albums

메서드	경로	권한
GET	`/api/v1/albums/{id}`	signed_in
PUT	`/api/v1/albums/{id}`	manage_library
GET	`/api/v1/albums/{id}/cover`	signed_in
GET	`/api/v1/albums/{id}/tracks`	signed_in

alerts

메서드	경로	권한
GET	`/api/v1/alerts`	settings
POST	`/api/v1/alerts`	settings
PUT	`/api/v1/alerts/{id}`	settings
DELETE	`/api/v1/alerts/{id}`	settings
POST	`/api/v1/alerts/{id}/test`	settings

app

메서드	경로	권한
GET	`/api/v1/app/about`	settings
POST	`/api/v1/app/restart`	users
POST	`/api/v1/app/safe-mode`	users
POST	`/api/v1/app/shutdown`	users
GET	`/api/v1/app/storage`	settings
GET	`/api/v1/app/update`	manage_library
POST	`/api/v1/app/update/check`	settings

artists

메서드	경로	권한	용도
POST	`/api/v1/artists`	manage_library
GET	`/api/v1/artists/lookup`	signed_in

artwork

메서드	경로	권한
GET	`/api/v1/artwork/img/{kind}/{id}/{file}`	signed_in
GET	`/api/v1/artwork/tmdb/{size}/{file}`	signed_in
GET	`/api/v1/artwork/{name}`	signed_in

ask-limits

메서드	경로	권한	용도
GET	`/api/v1/ask-limits`	users
PUT	`/api/v1/ask-limits/{id}`	users

asked-by

메서드	경로	권한	용도
GET	`/api/v1/asked-by`	signed_in

asks

메서드	경로	권한
GET	`/api/v1/asks`	signed_in
POST	`/api/v1/asks`	ask
GET	`/api/v1/asks/limit`	ask
GET	`/api/v1/asks/{id}`	signed_in
DELETE	`/api/v1/asks/{id}`	ask
POST	`/api/v1/asks/{id}/approve`	approve
GET	`/api/v1/asks/{id}/parts`	signed_in
POST	`/api/v1/asks/{id}/turn-down`	approve

auth

메서드	경로	권한
GET	`/api/v1/auth/ai-connect`	signed_in
POST	`/api/v1/auth/ai-connect`	settings
POST	`/api/v1/auth/forward/link`	self
POST	`/api/v1/auth/forward/login`	public
POST	`/api/v1/auth/import/{kind}`	owner
POST	`/api/v1/auth/import/{kind}/preview`	owner
GET	`/api/v1/auth/invites/{token}`	unlisted
POST	`/api/v1/auth/invites/{token}`	unlisted
POST	`/api/v1/auth/invites/{token}/media-server/{kind}`	unlisted
POST	`/api/v1/auth/invites/{token}/plex/finish`	unlisted
POST	`/api/v1/auth/invites/{token}/plex/start`	unlisted
GET	`/api/v1/auth/keys`	settings
POST	`/api/v1/auth/keys`	settings
DELETE	`/api/v1/auth/keys/{id}`	settings
POST	`/api/v1/auth/login`	unlisted
POST	`/api/v1/auth/login/two-factor`	unlisted
POST	`/api/v1/auth/logout`	self
GET	`/api/v1/auth/me`	self
POST	`/api/v1/auth/media-server/{kind}`	unlisted
POST	`/api/v1/auth/media-server/{kind}/test`	owner
GET	`/api/v1/auth/oidc/callback`	public
POST	`/api/v1/auth/oidc/finish`	public
POST	`/api/v1/auth/oidc/link`	self
POST	`/api/v1/auth/oidc/link-finish`	self
POST	`/api/v1/auth/oidc/start`	public
POST	`/api/v1/auth/password`	self
POST	`/api/v1/auth/plex/finish`	unlisted
DELETE	`/api/v1/auth/plex/link`	owner
POST	`/api/v1/auth/plex/link/finish`	owner
POST	`/api/v1/auth/plex/link/start`	owner
GET	`/api/v1/auth/plex/my-link`	self
DELETE	`/api/v1/auth/plex/my-link`	self
POST	`/api/v1/auth/plex/my-link/finish`	self
POST	`/api/v1/auth/plex/my-link/start`	self
POST	`/api/v1/auth/plex/start`	unlisted
POST	`/api/v1/auth/reauth`	self
GET	`/api/v1/auth/sessions`	self
DELETE	`/api/v1/auth/sessions`	self
DELETE	`/api/v1/auth/sessions/{sid}`	self
GET	`/api/v1/auth/settings`	settings
PUT	`/api/v1/auth/settings`	owner
POST	`/api/v1/auth/setup`	unlisted
GET	`/api/v1/auth/setup/discover`	unlisted
POST	`/api/v1/auth/setup/done`	owner
POST	`/api/v1/auth/setup/media-server/{kind}`	unlisted
POST	`/api/v1/auth/setup/plex/finish`	unlisted
POST	`/api/v1/auth/setup/plex/start`	unlisted
GET	`/api/v1/auth/sso`	owner
PUT	`/api/v1/auth/sso`	owner
GET	`/api/v1/auth/sso/links`	self
POST	`/api/v1/auth/sso/test`	owner
POST	`/api/v1/auth/sso/unlink`	self
GET	`/api/v1/auth/state`	unlisted
POST	`/api/v1/auth/two-factor/backup-codes`	self
POST	`/api/v1/auth/two-factor/disable`	self
POST	`/api/v1/auth/two-factor/enable`	self
POST	`/api/v1/auth/two-factor/setup`	self

backups

메서드	경로	권한
GET	`/api/v1/backups`	settings
POST	`/api/v1/backups`	settings
POST	`/api/v1/backups/restore`	owner
PUT	`/api/v1/backups/settings`	settings
GET	`/api/v1/backups/{name}`	owner
DELETE	`/api/v1/backups/{name}`	owner

bridges

메서드	경로	권한
GET	`/api/v1/bridges`	manage_library
POST	`/api/v1/bridges`	settings
POST	`/api/v1/bridges/find`	settings
POST	`/api/v1/bridges/test`	settings
DELETE	`/api/v1/bridges/{id}`	settings
POST	`/api/v1/bridges/{id}/check`	settings

calendar

메서드	경로	권한	용도
GET	`/api/v1/calendar`	signed_in

collections

메서드	경로	권한
GET	`/api/v1/collections`	signed_in
GET	`/api/v1/collections/{id}`	signed_in
POST	`/api/v1/collections/{id}/remove`	manage_library
POST	`/api/v1/collections/{id}/remove/preview`	manage_library

data-packs

메서드	경로	권한
GET	`/api/v1/data-packs`	owner
POST	`/api/v1/data-packs`	owner
POST	`/api/v1/data-packs/validate`	owner
GET	`/api/v1/data-packs/{id}`	owner
POST	`/api/v1/data-packs/{id}/apply`	owner
GET	`/api/v1/data-packs/{id}/preview`	owner

discover

메서드	경로	권한	용도
GET	`/api/v1/discover`	signed_in

downloaders

메서드	경로	권한
GET	`/api/v1/downloaders`	manage_library
POST	`/api/v1/downloaders`	settings
PUT	`/api/v1/downloaders/{id}`	settings
DELETE	`/api/v1/downloaders/{id}`	settings
GET	`/api/v1/downloaders/{id}/attempts`	settings
POST	`/api/v1/downloaders/{id}/attempts/{attemptID}/abandon`	settings
POST	`/api/v1/downloaders/{id}/bulk`	manage_library
POST	`/api/v1/downloaders/{id}/items/{hash}/bottom`	manage_library
GET	`/api/v1/downloaders/{id}/items/{hash}/detail`	manage_library
POST	`/api/v1/downloaders/{id}/items/{hash}/down`	manage_library
GET	`/api/v1/downloaders/{id}/items/{hash}/files`	manage_library
PUT	`/api/v1/downloaders/{id}/items/{hash}/files`	manage_library
POST	`/api/v1/downloaders/{id}/items/{hash}/pause`	manage_library
POST	`/api/v1/downloaders/{id}/items/{hash}/priority`	manage_library
POST	`/api/v1/downloaders/{id}/items/{hash}/reannounce`	manage_library
POST	`/api/v1/downloaders/{id}/items/{hash}/recheck`	manage_library
POST	`/api/v1/downloaders/{id}/items/{hash}/remove`	manage_library
POST	`/api/v1/downloaders/{id}/items/{hash}/resume`	manage_library
POST	`/api/v1/downloaders/{id}/items/{hash}/retry`	manage_library
GET	`/api/v1/downloaders/{id}/items/{hash}/swarm`	manage_library
POST	`/api/v1/downloaders/{id}/items/{hash}/top`	manage_library
POST	`/api/v1/downloaders/{id}/items/{hash}/trackers`	manage_library
PUT	`/api/v1/downloaders/{id}/items/{hash}/trackers`	manage_library
POST	`/api/v1/downloaders/{id}/items/{hash}/trackers/remove`	manage_library
POST	`/api/v1/downloaders/{id}/items/{hash}/up`	manage_library
GET	`/api/v1/downloaders/{id}/items/{hash}/usenet`	manage_library
POST	`/api/v1/downloaders/{id}/location`	manage_library
POST	`/api/v1/downloaders/{id}/pause`	settings
POST	`/api/v1/downloaders/{id}/resume`	settings
POST	`/api/v1/downloaders/{id}/share-limits`	manage_library
POST	`/api/v1/downloaders/{id}/slow-mode`	manage_library
PUT	`/api/v1/downloaders/{id}/speed-limit`	manage_library
POST	`/api/v1/downloaders/{id}/speed-limits`	manage_library
POST	`/api/v1/downloaders/{id}/test`	settings
POST	`/api/v1/downloaders/{id}/torrents`	manage_library

downloads

메서드	경로	권한
GET	`/api/v1/downloads`	manage_library
GET	`/api/v1/downloads/clients`	manage_library
GET	`/api/v1/downloads/matches`	manage_library
POST	`/api/v1/downloads/matches/run`	manage_library
POST	`/api/v1/downloads/matches/{id}/pick`	manage_library
POST	`/api/v1/downloads/pause-all`	manage_library
POST	`/api/v1/downloads/resume-all`	manage_library
GET	`/api/v1/downloads/view`	signed_in
GET	`/api/v1/downloads/{id}/detail`	manage_library
PUT	`/api/v1/downloads/{id}/edition`	manage_library
GET	`/api/v1/downloads/{id}/files`	manage_library
PUT	`/api/v1/downloads/{id}/files`	manage_library
POST	`/api/v1/downloads/{id}/mark-failed`	manage_library
POST	`/api/v1/downloads/{id}/pause`	manage_library
POST	`/api/v1/downloads/{id}/reannounce`	manage_library
POST	`/api/v1/downloads/{id}/recheck`	manage_library
POST	`/api/v1/downloads/{id}/remove`	manage_library
POST	`/api/v1/downloads/{id}/resume`	manage_library
GET	`/api/v1/downloads/{id}/swarm`	manage_library
POST	`/api/v1/downloads/{id}/top`	manage_library
GET	`/api/v1/downloads/{id}/usenet`	manage_library

episodes

메서드	경로	권한	용도
PUT	`/api/v1/episodes/{id}`	manage_library

events

메서드	경로	권한	용도
GET	`/api/v1/events`	manage_library

explore

메서드	경로	권한
GET	`/api/v1/explore/browse`	signed_in
GET	`/api/v1/explore/browse/category`	signed_in
GET	`/api/v1/explore/browse/section`	signed_in
POST	`/api/v1/explore/counts`	signed_in
GET	`/api/v1/explore/genre`	signed_in
GET	`/api/v1/explore/genre-row`	signed_in
GET	`/api/v1/explore/head`	signed_in
GET	`/api/v1/explore/music`	signed_in
GET	`/api/v1/explore/music/rising`	signed_in
GET	`/api/v1/explore/new`	signed_in
GET	`/api/v1/explore/new/music`	signed_in
GET	`/api/v1/explore/new/service`	signed_in
GET	`/api/v1/explore/new/services`	signed_in
GET	`/api/v1/explore/service-top`	signed_in
GET	`/api/v1/explore/strip`	signed_in
POST	`/api/v1/explore/strip/counts`	signed_in
DELETE	`/api/v1/explore/strip/counts`	signed_in
GET	`/api/v1/explore/tail`	signed_in
GET	`/api/v1/explore/title-stats`	owner
GET	`/api/v1/explore/top`	signed_in

extras

메서드	경로	권한	용도
GET	`/api/v1/extras/{kind}/{id}`	signed_in

files

메서드	경로	권한	용도
POST	`/api/v1/files/{id}/subtitles/choices`	manage_library
POST	`/api/v1/files/{id}/subtitles/choose`	manage_library

health

메서드	경로	권한
GET	`/api/v1/health`	manage_library
GET	`/api/v1/health/checks`	manage_library
POST	`/api/v1/health/checks/run`	manage_library
GET	`/api/v1/health/disks`	manage_library
GET	`/api/v1/health/states`	manage_library

held

메서드	경로	권한
GET	`/api/v1/held`	manage_library
DELETE	`/api/v1/held`	manage_library
DELETE	`/api/v1/held/{id}`	manage_library

holding

메서드	경로	권한
GET	`/api/v1/holding`	manage_library
POST	`/api/v1/holding/clean`	manage_library
POST	`/api/v1/holding/restore`	manage_library

home

메서드	경로	권한	용도
GET	`/api/v1/home`	signed_in

imports

메서드	경로	권한	용도
GET	`/api/v1/imports`	manage_library

jobs

메서드	경로	권한
GET	`/api/v1/jobs`	manage_library
GET	`/api/v1/jobs/active`	manage_library
GET	`/api/v1/jobs/{id}`	manage_library

library

메서드	경로	권한
GET	`/api/v1/library/copies`	manage_library
POST	`/api/v1/library/copies/search`	manage_library
POST	`/api/v1/library/copies/search/preview`	manage_library
GET	`/api/v1/library/search`	signed_in

library-folders

메서드	경로	권한
GET	`/api/v1/library-folders`	manage_library
POST	`/api/v1/library-folders`	settings
PUT	`/api/v1/library-folders/{id}`	settings
DELETE	`/api/v1/library-folders/{id}`	settings
POST	`/api/v1/library-folders/{id}/adopt`	manage_library
POST	`/api/v1/library-folders/{id}/check`	manage_library
POST	`/api/v1/library-folders/{id}/scan`	manage_library

links

메서드	경로	권한	용도
POST	`/api/v1/links/{kind}/{id}/restart`	users

live

메서드	경로	권한	용도
POST	`/api/v1/live/interest`	signed_in

logs

메서드	경로	권한	용도
GET	`/api/v1/logs`	users
GET	`/api/v1/logs/download`	users

manual-import

메서드	경로	권한	용도
POST	`/api/v1/manual-import`	settings
POST	`/api/v1/manual-import/scan`	settings

mcp

메서드	경로	권한	용도
GET	`/api/v1/mcp`	signed_in
POST	`/api/v1/mcp`	signed_in

media-servers

메서드	경로	권한
GET	`/api/v1/media-servers`	settings
POST	`/api/v1/media-servers`	settings
PUT	`/api/v1/media-servers/{id}`	settings
DELETE	`/api/v1/media-servers/{id}`	settings
POST	`/api/v1/media-servers/{id}/test`	settings

messages

메서드	경로	권한	용도
GET	`/api/v1/messages`	signed_in
POST	`/api/v1/messages/read`	signed_in

metadata

메서드	경로	권한
GET	`/api/v1/metadata/album/{mbid}/follow`	signed_in
PUT	`/api/v1/metadata/album/{mbid}/follow`	signed_in
DELETE	`/api/v1/metadata/album/{mbid}/follow`	signed_in
GET	`/api/v1/metadata/health`	signed_in
GET	`/api/v1/metadata/movie/{tmdb_id}/follow`	signed_in
PUT	`/api/v1/metadata/movie/{tmdb_id}/follow`	signed_in
DELETE	`/api/v1/metadata/movie/{tmdb_id}/follow`	signed_in
GET	`/api/v1/metadata/search`	signed_in
GET	`/api/v1/metadata/show/{tmdb_id}/follow`	signed_in
PUT	`/api/v1/metadata/show/{tmdb_id}/follow`	signed_in
DELETE	`/api/v1/metadata/show/{tmdb_id}/follow`	signed_in
GET	`/api/v1/metadata/show/{tmdb_id}/seasons/{number}`	signed_in
GET	`/api/v1/metadata/{kind}/{tmdb_id}`	signed_in
GET	`/api/v1/metadata/{kind}/{tmdb_id}/anime`	signed_in
GET	`/api/v1/metadata/{kind}/{tmdb_id}/more-from`	signed_in
GET	`/api/v1/metadata/{kind}/{tmdb_id}/reviews`	signed_in

migrate

메서드	경로	권한
POST	`/api/v1/migrate/dry-run`	users
GET	`/api/v1/migrate/moves`	users
POST	`/api/v1/migrate/moves`	users
GET	`/api/v1/migrate/moves/{id}`	users
GET	`/api/v1/migrate/moves/{id}/report`	users
POST	`/api/v1/migrate/moves/{id}/undo`	users
POST	`/api/v1/migrate/plan`	users
POST	`/api/v1/migrate/probe`	users
POST	`/api/v1/migrate/read`	users
GET	`/api/v1/migrate/saved-keys`	owner
DELETE	`/api/v1/migrate/saved-keys`	owner
GET	`/api/v1/migrate/snapshots`	users
GET	`/api/v1/migrate/snapshots/{id}`	users
DELETE	`/api/v1/migrate/snapshots/{id}`	users

music

메서드	경로	권한
GET	`/api/v1/music/albums/{mbid}`	signed_in
GET	`/api/v1/music/artists/{mbid}`	signed_in
GET	`/api/v1/music/browse-tiles`	signed_in
GET	`/api/v1/music/browse/{kind}/{slug}`	signed_in
GET	`/api/v1/music/genre-art/{slug}`	signed_in
GET	`/api/v1/music/genre/{slug}`	signed_in

메서드	경로	권한	용도
GET	`/api/v1/music-trending`	signed_in
GET	`/api/v1/music-trending/art/{kind}/{mbid}`	signed_in

my

메서드	경로	권한
GET	`/api/v1/my/alerts`	signed_in
PUT	`/api/v1/my/alerts`	signed_in
GET	`/api/v1/my/follows`	signed_in
GET	`/api/v1/my/plex-watchlist`	signed_in
PUT	`/api/v1/my/plex-watchlist`	signed_in
POST	`/api/v1/my/plex-watchlist/check`	signed_in
GET	`/api/v1/my/profile`	signed_in
PUT	`/api/v1/my/profile`	signed_in

needs-decision

메서드	경로	권한	용도
GET	`/api/v1/needs-decision`	manage_library
POST	`/api/v1/needs-decision/{id}/decide`	manage_library

never-add

메서드	경로	권한
GET	`/api/v1/never-add`	manage_library
POST	`/api/v1/never-add`	manage_library
DELETE	`/api/v1/never-add/{id}`	manage_library

openapi.json

메서드	경로	권한	용도
GET	`/api/v1/openapi.json`	signed_in

outside-lists

메서드	경로	권한
GET	`/api/v1/outside-lists`	settings
POST	`/api/v1/outside-lists`	settings
PUT	`/api/v1/outside-lists/{id}`	settings
DELETE	`/api/v1/outside-lists/{id}`	settings
POST	`/api/v1/outside-lists/{id}/sync`	settings

own-traits

메서드	경로	권한
GET	`/api/v1/own-traits`	manage_library
POST	`/api/v1/own-traits`	settings
PUT	`/api/v1/own-traits/{id}`	settings
DELETE	`/api/v1/own-traits/{id}`	settings

parts

메서드	경로	권한
GET	`/api/v1/parts`	signed_in
POST	`/api/v1/parts/{part}/off`	users
POST	`/api/v1/parts/{part}/on`	users
POST	`/api/v1/parts/{part}/restart`	users

people

메서드	경로	권한
GET	`/api/v1/people/popular`	signed_in
GET	`/api/v1/people/search`	signed_in
GET	`/api/v1/people/shelves`	signed_in
GET	`/api/v1/people/shelves/{id}`	signed_in
GET	`/api/v1/people/{id}`	signed_in
POST	`/api/v1/people/{id}/movies/review`	signed_in

pick-rules

메서드	경로	권한
GET	`/api/v1/pick-rules`	manage_library
POST	`/api/v1/pick-rules`	settings
GET	`/api/v1/pick-rules/{id}`	manage_library
PUT	`/api/v1/pick-rules/{id}`	settings
DELETE	`/api/v1/pick-rules/{id}`	settings

public

메서드	경로	권한	용도
GET	`/api/v1/public/signin-art`	public
GET	`/api/v1/public/signin-pic/t/p/{size}/{file}`	public	고정 패턴 (= signinPicPath + “{size}/{file}”): 경로 테스트가 소스에서 이 값을 읽습니다.

releases

메서드	경로	권한	용도
POST	`/api/v1/releases/{id}/choose`	manage_library
POST	`/api/v1/releases/{id}/turn-down`	manage_library

rename

메서드	경로	권한	용도
GET	`/api/v1/rename`	manage_library
POST	`/api/v1/rename`	manage_library

reports

메서드	경로	권한
GET	`/api/v1/reports`	signed_in
POST	`/api/v1/reports`	signed_in
POST	`/api/v1/reports/{id}/fix`	manage_library
POST	`/api/v1/reports/{id}/reopen`	manage_library

schedules

메서드	경로	권한
GET	`/api/v1/schedules`	manage_library
PUT	`/api/v1/schedules/{kind}`	settings
POST	`/api/v1/schedules/{kind}/run`	manage_library

search

메서드	경로	권한
GET	`/api/v1/search`	signed_in
POST	`/api/v1/search/better`	manage_library
POST	`/api/v1/search/feed-check`	manage_library
POST	`/api/v1/search/missing`	manage_library
GET	`/api/v1/search/suggest`	signed_in

searches

메서드	경로	권한	용도
GET	`/api/v1/searches`	manage_library

settings

메서드	경로	권한
GET	`/api/v1/settings/ai`	signed_in
PUT	`/api/v1/settings/ai`	owner
GET	`/api/v1/settings/alerts`	settings
PUT	`/api/v1/settings/alerts`	settings
GET	`/api/v1/settings/asks`	settings
PUT	`/api/v1/settings/asks`	settings
GET	`/api/v1/settings/downloaders`	settings
PUT	`/api/v1/settings/downloaders`	settings
GET	`/api/v1/settings/files`	manage_library
PUT	`/api/v1/settings/files`	settings
GET	`/api/v1/settings/health`	settings
PUT	`/api/v1/settings/health`	settings
GET	`/api/v1/settings/import-folders`	settings
PUT	`/api/v1/settings/import-folders`	users
POST	`/api/v1/settings/import-secrets`	owner
GET	`/api/v1/settings/music`	manage_library
PUT	`/api/v1/settings/music`	settings
GET	`/api/v1/settings/naming`	manage_library
PUT	`/api/v1/settings/naming`	settings
POST	`/api/v1/settings/naming/example`	manage_library
GET	`/api/v1/settings/old-app-api`	settings
PUT	`/api/v1/settings/old-app-api`	settings
POST	`/api/v1/settings/old-app-api/keys/{side}`	settings
DELETE	`/api/v1/settings/old-app-api/keys/{side}`	settings
GET	`/api/v1/settings/release-gate`	manage_library
PUT	`/api/v1/settings/release-gate`	settings
GET	`/api/v1/settings/search`	settings
PUT	`/api/v1/settings/search`	settings
GET	`/api/v1/settings/shows`	manage_library
PUT	`/api/v1/settings/shows`	settings
GET	`/api/v1/settings/status`	settings
GET	`/api/v1/settings/subtitles`	settings
PUT	`/api/v1/settings/subtitles`	settings
GET	`/api/v1/settings/title-defaults`	manage_library
PUT	`/api/v1/settings/title-defaults`	settings
GET	`/api/v1/settings/trakt-key`	settings
PUT	`/api/v1/settings/trakt-key`	settings
GET	`/api/v1/settings/trakt-token`	owner
PUT	`/api/v1/settings/trakt-token`	owner
GET	`/api/v1/settings/ui`	signed_in
PUT	`/api/v1/settings/ui`	settings
GET	`/api/v1/settings/url-base`	settings
PUT	`/api/v1/settings/url-base`	settings

shows

메서드	경로	권한	용도
POST	`/api/v1/shows`	manage_library
GET	`/api/v1/shows/lookup`	signed_in

sources

메서드	경로	권한
GET	`/api/v1/sources`	manage_library
POST	`/api/v1/sources`	settings
POST	`/api/v1/sources/check`	settings
PUT	`/api/v1/sources/{id}`	settings
DELETE	`/api/v1/sources/{id}`	settings
POST	`/api/v1/sources/{id}/pause`	settings
POST	`/api/v1/sources/{id}/resume`	settings
GET	`/api/v1/sources/{id}/stats`	manage_library
POST	`/api/v1/sources/{id}/test`	settings
POST	`/api/v1/sources/{id}/try`	settings

stages

메서드	경로	권한
POST	`/api/v1/stages/{name}/pause`	users
POST	`/api/v1/stages/{name}/restart`	users
POST	`/api/v1/stages/{name}/resume`	users

subtitle-sites

메서드	경로	권한
GET	`/api/v1/subtitle-sites`	manage_library
POST	`/api/v1/subtitle-sites`	settings
GET	`/api/v1/subtitle-sites/kinds`	manage_library
PUT	`/api/v1/subtitle-sites/{id}`	settings
DELETE	`/api/v1/subtitle-sites/{id}`	settings
POST	`/api/v1/subtitle-sites/{id}/test`	settings

subtitles

메서드	경로	권한
GET	`/api/v1/subtitles/languages`	manage_library
GET	`/api/v1/subtitles/missing`	manage_library
POST	`/api/v1/subtitles/missing/search`	manage_library
POST	`/api/v1/subtitles/search`	manage_library
POST	`/api/v1/subtitles/{id}/sync`	manage_library
POST	`/api/v1/subtitles/{id}/turn-down`	manage_library

support

메서드	경로	권한	용도
GET	`/api/v1/support/bundle`	users

system

메서드	경로	권한	용도
POST	`/api/v1/system/key-kit`	owner

titles

메서드	경로	권한
GET	`/api/v1/titles`	signed_in
POST	`/api/v1/titles`	manage_library
GET	`/api/v1/titles/lookup`	signed_in
GET	`/api/v1/titles/owned`	signed_in
POST	`/api/v1/titles/refresh`	manage_library
GET	`/api/v1/titles/{id}`	signed_in
PUT	`/api/v1/titles/{id}`	manage_library
GET	`/api/v1/titles/{id}/albums`	signed_in
PUT	`/api/v1/titles/{id}/artist`	manage_library
GET	`/api/v1/titles/{id}/copies`	manage_library
POST	`/api/v1/titles/{id}/delete`	manage_library
GET	`/api/v1/titles/{id}/episodes`	signed_in
PUT	`/api/v1/titles/{id}/files/{fid}/choices`	manage_library
POST	`/api/v1/titles/{id}/files/{fid}/keep-and-add`	manage_library
GET	`/api/v1/titles/{id}/follow`	signed_in
PUT	`/api/v1/titles/{id}/follow`	signed_in
DELETE	`/api/v1/titles/{id}/follow`	signed_in
POST	`/api/v1/titles/{id}/move`	manage_library
GET	`/api/v1/titles/{id}/people`	signed_in
POST	`/api/v1/titles/{id}/refresh`	manage_library
GET	`/api/v1/titles/{id}/releases`	manage_library
GET	`/api/v1/titles/{id}/rename`	manage_library
POST	`/api/v1/titles/{id}/rename`	manage_library
POST	`/api/v1/titles/{id}/search`	manage_library
GET	`/api/v1/titles/{id}/search-outcome`	signed_in
GET	`/api/v1/titles/{id}/seasons`	signed_in
PUT	`/api/v1/titles/{id}/seasons/{number}`	manage_library
PUT	`/api/v1/titles/{id}/subtitle-wish`	manage_library
GET	`/api/v1/titles/{id}/subtitles`	manage_library
POST	`/api/v1/titles/{id}/versions`	manage_library
PUT	`/api/v1/titles/{id}/versions/{vid}`	manage_library
DELETE	`/api/v1/titles/{id}/versions/{vid}`	manage_library
POST	`/api/v1/titles/{id}/versions/{vid}/adopt`	manage_library

trailer

메서드	경로	권한
GET	`/api/v1/trailer/batch`	signed_in
GET	`/api/v1/trailer/stream/{id}/manifest.m3u8`	signed_in
GET	`/api/v1/trailer/stream/{id}/seg/{n}`	signed_in
GET	`/api/v1/trailer/{kind}/{tmdb_id}`	signed_in

turned-down

메서드	경로	권한
GET	`/api/v1/turned-down`	manage_library
DELETE	`/api/v1/turned-down`	manage_library
DELETE	`/api/v1/turned-down/{id}`	manage_library

users

메서드	경로	권한
GET	`/api/v1/users`	users
GET	`/api/v1/users/invites`	users
POST	`/api/v1/users/invites`	users
DELETE	`/api/v1/users/invites/{id}`	users
PUT	`/api/v1/users/{id}`	users
GET	`/api/v1/users/{id}/avatar`	signed_in
POST	`/api/v1/users/{id}/password`	users
GET	`/api/v1/users/{id}/sessions`	users
POST	`/api/v1/users/{id}/sessions/end-all`	users
DELETE	`/api/v1/users/{id}/sessions/{sid}`	users
POST	`/api/v1/users/{id}/sso/unlink`	owner
POST	`/api/v1/users/{id}/two-factor/reset`	users

watch-services

메서드	경로	권한	용도
GET	`/api/v1/watch-services`	signed_in

wiki

메서드	경로	권한	용도
GET	`/api/v1/wiki/{kind}/{id}`	signed_in

기타 (/api/v1 밖)

메서드	경로	권한	용도
GET	`/`	self
POST	`/`	unlisted
GET	`/.well-known/oauth-authorization-server`	public
GET	`/.well-known/oauth-protected-resource`	public
GET	`/.well-known/oauth-protected-resource/{path...}`	public
GET	`/calendar`	unlisted
POST	`/command`	unlisted
GET	`/command/{id}`	unlisted
GET	`/episode`	unlisted
PUT	`/episode/monitor`	unlisted
GET	`/healthz`	unlisted
GET	`/indexer`	unlisted
POST	`/indexer`	unlisted
GET	`/indexer/schema`	unlisted
POST	`/indexer/test`	unlisted
GET	`/indexer/{id}`	unlisted
PUT	`/indexer/{id}`	unlisted
DELETE	`/indexer/{id}`	unlisted
GET	`/languageprofile`	unlisted
GET	`/live`	signed_in
GET	`/login`	self
GET	`/mcp`	signed_in
POST	`/mcp`	signed_in
GET	`/mediacover/{id}/{file}`	unlisted
GET	`/movie`	unlisted
POST	`/movie`	unlisted
PUT	`/movie`	unlisted
GET	`/movie/lookup`	unlisted
GET	`/movie/{id}`	unlisted
PUT	`/movie/{id}`	unlisted
DELETE	`/movie/{id}`	unlisted
GET	`/oauth/authorize`	public
POST	`/oauth/register`	public
POST	`/oauth/token`	public
GET	`/qualityprofile`	unlisted
GET	`/queue`	unlisted
GET	`/queue/details`	unlisted
GET	`/radarr/`	manage_library
POST	`/radarr/`	manage_library
PUT	`/radarr/`	manage_library
DELETE	`/radarr/`	manage_library
GET	`/readyz`	unlisted	시작 페이지는 503으로 응답합니다).
GET	`/rootfolder`	unlisted
GET	`/series`	unlisted
POST	`/series`	unlisted
PUT	`/series`	unlisted
GET	`/series/lookup`	unlisted
GET	`/series/{id}`	unlisted
PUT	`/series/{id}`	unlisted
DELETE	`/series/{id}`	unlisted
GET	`/sonarr/`	manage_library
POST	`/sonarr/`	manage_library
PUT	`/sonarr/`	manage_library
DELETE	`/sonarr/`	manage_library
GET	`/system/status`	unlisted
GET	`/tag`	unlisted
POST	`/tag`	unlisted
PUT	`/tag`	unlisted
PUT	`/tag/{id}`	unlisted
GET	`/wanted/missing`	unlisted

HolyArrs는 무료입니다. 시간을 아끼는 데 도움이 됐다면 GitHub에서 스타를 누르거나, 후원하거나, 커피 한 잔을 사 주세요.