모델 레지스트리: 스테이지 매트릭스, 버전 이력, 일대일 비교 및 프로덕션 승격 요청.

GET /api/v1/models

GET/api/v1/models

스테이지 매트릭스를 포함한 등록 모델 목록

테넌트의 등록된 모델을 스테이지별 매트릭스와 함께 나열합니다.

필요 권한: VIEW

파라미터

이름위치형식필수설명
productionqueryboolean?true = Production 버전이 있는 모델만, false = 없는 모델만
pagequeryinteger
page_sizequeryinteger?
qquerystring?이름 부분 일치 검색
sortquerystring?정렬 키
orderquerystringasc | desc

응답

상태설명
200Successful Response (object)
422Validation Error (HTTPValidationError)

GET /api/v1/models/summary

GET/api/v1/models/summary

production/staging/archived 개수

테넌트의 모델 개수를 스테이지별로 집계합니다.

필요 권한: VIEW

응답

상태설명
200Successful Response (object)

GET /api/v1/models/{name}/versions

GET/api/v1/models/{name}/versions

버전 이력

등록된 모델의 전체 버전 이력을 반환합니다.

필요 권한: VIEW

파라미터

이름위치형식필수설명
namepathstring
pagequeryinteger
page_sizequeryinteger?

응답

상태설명
200Successful Response (object)
422Validation Error (HTTPValidationError)

GET /api/v1/models/{name}/versions/{version}

GET/api/v1/models/{name}/versions/{version}

모델 버전 단건 조회

모델 버전 하나를 반환합니다.

필요 권한: VIEW

파라미터

이름위치형식필수설명
namepathstring
versionpathstring

응답

상태설명
200Successful Response (object)
422Validation Error (HTTPValidationError)

GET /api/v1/models/{name}/{version}/download

GET/api/v1/models/{name}/{version}/download

모델 버전 아티팩트 다운로드

모델 버전의 아티팩트를 파일로 내려받습니다.

필요 권한: VIEW

파라미터

이름위치형식필수설명
namepathstring
versionpathstring

응답

상태설명
200Successful Response (object)
422Validation Error (HTTPValidationError)

GET /api/v1/models/{name}/compare

GET/api/v1/models/{name}/compare

두 모델 버전 비교

모델의 두 버전을 나란히 일대일 비교합니다.

필요 권한: VIEW

파라미터

이름위치형식필수설명
namepathstring
fromquerystring
toquerystring

응답

상태설명
200Successful Response (object)
422Validation Error (HTTPValidationError)

GET /api/v1/models/{name}/{version}/comments

GET/api/v1/models/{name}/{version}/comments

일대일 비교 코멘트 목록

특정 모델 버전에 대한 일대일 비교(H2H) 코멘트를 나열합니다.

필요 권한: VIEW

파라미터

이름위치형식필수설명
namepathstring
versionpathstring

응답

상태설명
200Successful Response (object)
422Validation Error (HTTPValidationError)

POST /api/v1/models/{name}/{version}/comments

POST/api/v1/models/{name}/{version}/comments

코멘트 추가

모델 버전에 일대일 비교(H2H) 코멘트를 추가합니다.

필요 권한: DEVELOP

파라미터

이름위치형식필수설명
namepathstring
versionpathstring

요청 본문: application/json, CommentCreate

필드형식필수설명
bodystringBody

응답

상태설명
201Successful Response (object)
422Validation Error (HTTPValidationError)

POST /api/v1/models/{name}/{version}/promote

POST/api/v1/models/{name}/{version}/promote

프로덕션 승격 요청

모델 버전을 Production으로 승격하도록 요청합니다(화면 8 진입점).

필요 권한: PRODUCTION_PROMOTE

파라미터

이름위치형식필수설명
namepathstring
versionpathstring

요청 본문: application/json, PromoteRequest

필드형식필수설명
to_versionstringTo Version
reasonstringReason
rollback_conditionsstring?Rollback Conditions
scopestring?Scope

응답

상태설명
201Successful Response (object)
422Validation Error (HTTPValidationError)

POST /api/v1/models/{name}/{version}/stage

POST/api/v1/models/{name}/{version}/stage

모델 버전 스테이지 강등

모델 버전을 Archived/Staging/None 스테이지로 옮깁니다.

필요 권한: STAGING_PROMOTE

파라미터

이름위치형식필수설명
namepathstring
versionpathstring

요청 본문: application/json, StageChange

필드형식필수설명
stagestringStage

응답

상태설명
200Successful Response (object)
422Validation Error (HTTPValidationError)

DELETE /api/v1/models/{name}/{version}

DELETE/api/v1/models/{name}/{version}

모델 버전 등록 해제

등록된 모델에서 버전 하나를 삭제합니다.

필요 권한: MODEL_REGISTER

파라미터

이름위치형식필수설명
namepathstring
versionpathstring

응답

상태설명
204Successful Response
422Validation Error (HTTPValidationError)

DELETE /api/v1/models/{name}

DELETE/api/v1/models/{name}

등록 모델 삭제

등록된 모델을 전체 버전과 함께 레지스트리에서 삭제합니다.

필요 권한: MODEL_REGISTER

파라미터

이름위치형식필수설명
namepathstring

응답

상태설명
204Successful Response
422Validation Error (HTTPValidationError)

2026-09-21 기준 플랫폼에 맞춰 작성했습니다.

© Geo-MLOps