GET /projects/:projectId - ARGOS Identity

API 키가 속한 프로젝트를 조회합니다. 프로젝트 생성·수정·삭제는 API로 제공하지 않습니다. 대시보드에서 합니다.

엔드포인트

GET /v1/projects/{projectId}

요청

경로 파라미터

파라미터	타입	설명
`projectId`	`string`	조회할 프로젝트 ID (`proj_` 접두사)

curl "https://client-omni-api.argosidentity.com/v1/projects/proj_75hgxoxamzn9" \
  -H "x-api-key: your-api-key-here"

API 키가 속하지 않은 프로젝트를 요청하면 403 OMNI_5001이 반환됩니다.

응답

{
  "id": "proj_75hgxoxamzn9",
  "displayId": "PID-75hgxo",
  "userId": "user_7b3k9m1x5p8t",
  "name": "Demo",
  "description": "데모용 프로젝트",
  "status": "trial",
  "workflowsCount": 1,
  "workflows": [
    {
      "id": "wf_knsb7si44x27",
      "name": "거래처 온보딩 서류 검증 정책",
      "status": "active",
      "profilesCount": 1
    }
  ],
  "apiKeysCount": 1,
  "membersCount": 1,
  "owner": {
    "id": "user_7b3k9m1x5p8t",
    "email": "admin@example.com",
    "name": null
  },
  "createdAt": "2026-09-09T08:41:12.000Z",
  "updatedAt": "2026-09-09T09:00:16.884Z"
}

응답 필드

필드	타입	설명
`id`	`string`	프로젝트 ID (`proj_` 접두사)
`displayId`	`string`	화면 표시용 축약 ID (`PID-` 접두사)
`userId`	`string`	소유자 사용자 ID (`user_` 접두사)
`name`	`string`	프로젝트 이름
`description`	`string \| null`	설명
`status`	`string`	프로젝트 상태. 소문자로 반환됩니다(예: `trial`)
`workflowsCount`	`number`	이 프로젝트의 워크플로우 수
`workflows`	`object[]`	워크플로우 목록(최대 10개). 아래 표
`apiKeysCount`	`number`	활성 API 키 수
`membersCount`	`number`	활성 멤버 수
`owner`	`object`	소유자 정보. 아래 표
`createdAt`	`string`	생성 시각
`updatedAt`	`string`	수정 시각

체험판 남은 기간과 만료일은 이 응답에 없습니다. 대시보드의 프로젝트 정보 탭에서 확인하세요 — 프로젝트 관리.

`workflows`

필드	타입	설명
`id`	`string`	워크플로우 ID (`wf_` 접두사)
`name`	`string`	워크플로우 이름
`status`	`string`	`active` · `archived`
`profilesCount`	`number`	연결된 프로파일 수

전체 정의가 필요하면 GET /workflows/:workflowId를 사용하세요.

`owner`

필드	타입	설명
`id`	`string`	사용자 ID (`user_` 접두사)
`email`	`string`	소유자 이메일
`name`	`string \| null`	소유자 이름. 미설정이면 `null`

에러 코드

상태	코드	설명
404	`OMNI_3002`	프로젝트를 찾을 수 없음

공통 에러(400 요청 검증 · 401 인증 · 403 권한 · 500 서버 오류)는 API 개요를 참조하세요.

⌘I