> ## Documentation Index > Fetch the complete documentation index at: https://docs.didit.me/llms.txt > Use this file to discover all available pages before exploring further. # 주요 인물 KYC 세션 재생성 API > 만료되었거나 삭제되어 시작하지 못한 KYB 주요 인물의 새 KYC 세션을 생성하고 새 링크를 이메일로 보냅니다. Didit API로 처리합니다. Regenerate Key People KYC Session API 프롬프트 프롬프트를 클립보드에 복사 \

\`Give a Key People party of a Didit Business Verification (KYB) session a new individual KYC session through the API.

Endpoint:
POST https://verification.didit.me/v3/session/{session_id}/kyb/parties/{party_uuid}/regenerate/
(no request body)

Authentication:
Send my Didit API key in the x-api-key header. A scoped key needs decisions: write.

Goal:
\- Re-verify a person (UBO, director, other key person) whose individual KYC session was deleted, or expired before the person started it. Neither link lets the person complete verification. An expired child can cause the business session to become Declined; regenerate the party to issue a fresh link.

Behavior:
\- {session_id} is the parent business session; {party_uuid} is key_people_checks[].submitted.parties[].uuid from its decision and must belong to that session.
\- Works when the party's KYC session was deleted (kyc_session_deleted: true) or expired before the person started it. A session still in progress or one that ended in another status (Approved, Declined, In Review, Abandoned...) returns 409 unless it was deleted. A party that never had one or a company party always returns 409.
\- Deleted sessions qualify even if the person had already started or finished verification. Imported sessions do not qualify through expiry; they must have been deleted.
\- Didit creates a new hosted KYC session for the person, with the workflow the party was verified with (its latest published version) or, when that is no longer known, the workflow my Key People settings assign to the person's role. The new link lasts that KYC workflow's session expiration time, not the business session's. Its vendor_data is kyb-party-PARTY_UUID.
\- Didit emails the verification link to the party's email, when there is one.
\- is_skipped is cleared, so the Key People check waits on the new session.
\- The Key People check and the business session status are recomputed at once.
\- A data.updated webhook is sent for the business session with trigger "console_key_people_regenerate".
\- To exempt the party instead of re-verifying them, use PATCH /v3/session/{session_id}/kyb/parties/{party_uuid}/ with {"is_skipped": true}.

Example call:
curl -X POST "https://verification.didit.me/v3/session/33333333-4444-5555-6666-777777777777/kyb/parties/0a3f1e2c-7c2f-4a1b-9d55-2f8d2a5d6b41/regenerate/" \
-H "x-api-key: YOUR_API_KEY"

What to read from the response (the updated party):
\- kyc_session_id: the new KYC session.
\- kyc_session_url: its hosted link, to share yourself if the party has no email. A scoped key without sessions: write receives it as null.
\- kyc_session_status (Not Started), kyc_session_deleted (false), is_skipped (false).

Failure modes:
\- 401: the API key has expired.
\- 403: missing key (a wrong, revoked or expired key gets 401), a key of another application, a scoped key without decisions: write, or a request from outside the key's IP allowlist.
\- 404: the session does not exist, was deleted, or is outside a scoped key's limits; no party has this UUID; or the party belongs to another session.
\- 409 with code kyb_party_kyc_session_not_deleted: no eligible KYC session to replace. A person qualifies only when their session was deleted or a non-imported session expired before the person started it. All other sessions, a party that never had one, and company parties are rejected.

Side effects: creates a KYC session, may send an email to the party, recomputes the business session status and sends a data.updated webhook.

For the full integration shape, see /integration/integration-prompt.`

\
붙여넣을 곳 이전 링크가 더 이상 작동하지 않을 때 이 기능을 사용합니다. 세션이 삭제되었거나, 사람이 세션을 시작하기 전에 만료된 경우가 해당합니다. 사람이 이미 인증을 시작했거나 완료한 경우에도 세션이 삭제되었다면 재생성 대상이 됩니다. 가져온 세션은 만료로는 대상이 되지 않으며, 반드시 삭제되어 있어야 합니다. 삭제되지 않았고 사람이 이미 시작한 세션은 만료를 이유로 재생성할 수 없습니다.새 세션은 같은 당사자에 연결되므로, 원래 세션과 마찬가지로 그 결과가 Key People 검사에 반영됩니다. 링크의 유효 기간은 기업 세션이 아니라 해당 세션을 실행하는 KYC 워크플로의 세션 만료 시간(1시간에서 4주)을 따릅니다. 당사자와 그 하위 세션은 [기업 세션 결정](https://docs.didit.me/ko/business-verification/response-schema.md#key_people_checks)에서 확인하십시오. 해당 사람을 인증하지 않아야 한다면 대신 [당사자를 건너뛰십시오](https://docs.didit.me/ko/sessions-api/update-data.md#주요-인물-당사자-건너뛰기). 당사자와 해당 당사자의 인증이 작동하는 방식은 [Key People](https://docs.didit.me/ko/business-verification/key-people.md)을 참조하십시오. ## OpenAPI ````yaml ko/openapi-25.json POST /v3/session/{sessionId}/kyb/parties/{partyUuid}/regenerate/ openapi: 3.0.0 info: version: 3.0.0 title: Didit Verification API description: 신분증 인증 API입니다. x-api-key 헤더로 인증합니다. servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/session/{sessionId}/kyb/parties/{partyUuid}/regenerate/: post: tags: - Sessions summary: 주요 인물 당사자의 KYC 세션 재생성 description: >- 기업 확인(KYB) 세션의 주요 인물 당사자에게 이전 개인 KYC 세션이 삭제되었거나 해당 인물이 시작하기 전에 만료된 후 새로운 개인 KYC 세션을 부여하여 주요 인물 확인을 다시 완료할 수 있도록 합니다. 요청 본문은 전송하지 마십시오. 당사자의 KYC 세션이 삭제되었거나(`kyc_session_deleted: true`) 해당 인물이 시작하기 전에 만료된 경우(`Expired`, 시작되지 않음)에 작동합니다. 아직 진행 중인 세션이나 다른 상태(`Approved`, `Declined`, `In Review`, `Abandoned`, ...)로 종료된 세션은 삭제되지 않은 한 `409`를 반환합니다. 세션이 없었던 당사자나 기업 당사자는 항상 `409`를 반환합니다. Didit은 해당 당사자가 인증받았던 워크플로(최신 게시된 버전) 또는 더 이상 알 수 없는 경우 주요 인물 설정에서 당사자의 역할에 할당한 워크플로를 사용하여 새로운 호스팅 KYC 세션을 생성하므로, 해당 링크의 유효 기간은 해당 KYC 워크플로의 세션 만료 시간 동안 지속됩니다. 이메일이 등록되어 있으면 해당 당사자에게 링크를 이메일로 전송하고, `is_skipped`를 지우며, 주요 인물 확인 및 기업 세션 상태를 다시 계산합니다. 그런 다음 트리거 `console_key_people_regenerate`와 함께 기업 세션에 대한 `data.updated` [webhook](https://docs.didit.me/ko/integration/webhooks)을 전송합니다. 당사자를 대신 제외하려면 `PATCH /v3/session/{sessionId}/kyb/parties/{partyUuid}/`를 사용하십시오. 범위가 지정된 API 키에는 `decisions: write`가 필요하며, `sessions: write`가 없으면 `kyc_session_url`을 `null`로 수신합니다. 삭제된 세션은 해당 인물이 이미 인증을 시작했거나 완료했더라도 대상이 됩니다. 가져온 세션은 만료를 통해서는 대상이 되지 않으며, 반드시 삭제되었어야 합니다. operationId: post_v3_session_kyb_party_regenerate parameters: - name: sessionId in: path required: true description: 상위 기업 확인(KYB) 세션의 UUID입니다. schema: type: string format: uuid example: 33333333-4444-5555-6666-777777777777 - name: partyUuid in: path required: true description: >- 주요 인물(Key People) 당사자의 UUID(기업 세션 결정의 `key_people_checks[].submitted.parties[].uuid`)입니다. `sessionId`로 참조되는 세션에 속해 있어야 합니다. schema: type: string format: uuid example: 0a3f1e2c-7c2f-4a1b-9d55-2f8d2a5d6b41 responses: '200': description: >- 새 KYC 세션이 생성되었습니다. 업데이트된 당사자와 해당 KYC 워크플로의 세션 만료 시간 이후 만료되는 새 하위 세션을 반환합니다. content: application/json: schema: $ref: '#/components/schemas/KYBKeyPeopleParty' example: uuid: 0a3f1e2c-7c2f-4a1b-9d55-2f8d2a5d6b41 entity_type: person source: USER name: Jane Smith first_name: Jane last_name: Smith company_name: null registration_number: null email: user@example.com nationality: GB phone_number: null date_of_birth: '1980-05-04' position: Director custom_fields: {} is_active: true is_skipped: false requires_verification: true roles: - role: director ownership_percent: null voting_percent: null kyc_session_id: 55555555-6666-7777-8888-999999999999 kyc_session_status: Not Started kyc_session_url: https://verify.didit.me/session/abc123def456 kyc_session_deleted: false kyb_sub_session_id: null kyb_sub_session_status: null kyb_sub_session_url: null kyb_sub_session_deleted: false verification_workflow_type: kyc verification_workflow_id: 12121212-3434-5656-7878-909090909090 verification_workflow_label: Key People KYC verification_workflow_features: - feature: ID_VERIFICATION status: Not Finished - feature: LIVENESS status: Not Finished - feature: AML status: Not Finished didit_internal_id: null '401': description: >- 스코프가 지정된 API 키가 만료되었습니다. `401`이 반환되는 유일한 경우이며, 누락되었거나 유효하지 않거나 폐기된 키에는 `403`이 반환됩니다. content: application/json: schema: type: object properties: detail: type: string description: 사람이 읽기 쉬운 오류 메시지입니다. examples: Expired key: summary: 키의 만료일이 지났습니다 value: detail: This API key has expired. '403': description: >- 인증 또는 권한 부여에 실패했습니다. 키가 누락된 경우 `403`이 반환되며, 다른 애플리케이션의 키, 이 endpoint에 필요한 권한이 없는 범위 지정 키, 키의 IP 허용 목록 외부에서 보낸 요청의 경우에도 마찬가지입니다. 잘못되었거나 취소되었거나 만료된 키는 `401`을 반환합니다. `detail`로 구분하십시오. content: application/json: schema: type: object properties: detail: type: string description: 사람이 읽기 쉬운 오류 메시지입니다. examples: Missing or invalid credentials: summary: x-api-key 헤더가 없거나 키 검증에 실패했습니다 value: detail: >- Authentication credentials were not provided or are invalid. Other application: summary: 세션과 다른 애플리케이션에 속한 유효한 키입니다 value: detail: You do not have permission to perform this action. Scoped key without decisions write: summary: '스코프 지정 키에 decisions: write 권한이 없음' value: detail: This API key has no write access to decisions. IP not allowed: summary: 키의 IP 허용 목록 외부로부터의 요청 value: detail: This API key can't be used from this IP address. '404': description: >- 세션이 존재하지 않거나, 삭제되었거나, 범위가 지정된 키의 제한 범위를 벗어났습니다. 또는 애플리케이션에 이 UUID를 가진 당사자가 없거나, 해당 당사자가 다른 세션에 속해 있습니다. 각 사례마다 고유한 `detail`이 있습니다. 세션 조회가 자격 증명 확인보다 먼저 실행되므로, 유효한 키가 없더라도 알 수 없는 `sessionId`에 대해 `404`를 반환합니다. content: application/json: schema: type: object properties: detail: type: string description: 사람이 읽기 쉬운 오류 메시지입니다. examples: Unknown session: summary: 이 ID를 가진 세션이 존재하지 않거나 삭제되었습니다 value: detail: Not found. Outside key limits: summary: 세션이 범위가 지정된 키의 워크플로 또는 승인 전용 제한 범위를 벗어났습니다 value: detail: Session not found. Unknown party: summary: 귀하의 애플리케이션에 이 UUID를 가진 당사자가 없습니다 value: detail: No BusinessParty matches the given query. Party of another session: summary: partyUuid가 존재하지만 다른 세션에 속해 있음 value: detail: Party does not belong to the given session. '409': description: >- 해당 당사자에게 대체할 수 있는 적격 KYC 세션이 없습니다. 삭제되지 않은 한, 여전히 진행 중인 세션이나 다른 상태(`Approved`, `Declined`, `In Review`, `Abandoned` 등)로 끝난 세션은 재생성할 수 없습니다. 세션을 가진 적이 없는 당사자나 기업 당사자 역시 `409`를 반환합니다. 적격 세션은 사용자가 시작하기 전에 삭제되었거나 만료된 세션입니다. 삭제된 세션은 사용자가 이미 인증을 시작했거나 완료했더라도 자격이 주어집니다. 가져온 세션은 만료를 통해 자격이 주어지지 않으며, 반드시 삭제되었어야 합니다. `code`에 따라 분기 처리하세요. content: application/json: schema: type: object required: - detail - code properties: detail: type: string description: 사람이 읽기 쉬운 오류 메시지입니다. code: type: string enum: - kyb_party_kyc_session_not_deleted description: 기계 판독 가능한 고정 오류 코드입니다. example: detail: >- This party's KYC session is still live (it has neither been deleted nor expired without starting), so it cannot be regenerated. code: kyb_party_kyc_session_not_deleted '429': description: >- 속도 제한을 초과했습니다. API 키당 분당 300회의 쓰기(POST, PATCH, DELETE) 요청으로 제한됩니다. 재시도하기 전에 `Retry-After`초 동안 대기하세요. `X-RateLimit-*` 헤더에 한도 정보가 표시됩니다. content: application/json: schema: type: object properties: detail: type: string description: 사람이 읽기 쉬운 오류 메시지입니다. examples: Rate limited: summary: 현재 분에 할당된 예산이 소진되었습니다 value: detail: >- Write request rate limit exceeded. You can make up to 300 requests per minute. headers: Retry-After: description: 재시도하기 전 대기할 시간(초)입니다. schema: type: integer minimum: 1 example: 30 security: - ApiKeyAuth: [] x-codeSamples: - lang: curl label: curl source: >- curl -X POST 'https://verification.didit.me/v3/session/33333333-4444-5555-6666-777777777777/kyb/parties/0a3f1e2c-7c2f-4a1b-9d55-2f8d2a5d6b41/regenerate/' \ -H 'x-api-key: YOUR_API_KEY' - lang: python label: Python source: |- from didit import Didit # Reads DIDIT_API_KEY. client = Didit() result = client.sessions.regenerate_kyb_party( "33333333-4444-5555-6666-777777777777", "0a3f1e2c-7c2f-4a1b-9d55-2f8d2a5d6b41", ) print(result) - lang: javascript label: Node.js source: |- import Didit from "@didit-protocol/sdk-node"; // Reads DIDIT_API_KEY. const didit = new Didit(); const result = await didit.sessions.regenerateKybParty( "33333333-4444-5555-6666-777777777777", "0a3f1e2c-7c2f-4a1b-9d55-2f8d2a5d6b41", ); console.log(result); - lang: go label: Go source: "ctx := context.Background()\n// Reads DIDIT_API_KEY.\nclient := didit.NewClient()\n\nresult, err := client.Sessions.RegenerateKYBParty(ctx, \"33333333-4444-5555-6666-777777777777\", \"0a3f1e2c-7c2f-4a1b-9d55-2f8d2a5d6b41\")\nif err != nil {\n\tlog.Fatal(err)\n}\nfmt.Printf(\"%+v\\n\", result)" - lang: java label: Java source: >- import me.didit.Didit; // Reads DIDIT_API_KEY. Didit client = new Didit(); var result = client.sessions().regenerateKybParty("33333333-4444-5555-6666-777777777777", "0a3f1e2c-7c2f-4a1b-9d55-2f8d2a5d6b41"); System.out.println(result); - lang: php label: PHP source: >- sessions->regenerateKybParty('33333333-4444-5555-6666-777777777777', '0a3f1e2c-7c2f-4a1b-9d55-2f8d2a5d6b41'); print_r($result->toArray()); - lang: ruby label: Ruby source: |- require "didit" # Reads DIDIT_API_KEY. didit = Didit::Client.new result = didit.sessions.regenerate_kyb_party( "33333333-4444-5555-6666-777777777777", "0a3f1e2c-7c2f-4a1b-9d55-2f8d2a5d6b41" ) puts result.to_h - lang: csharp label: .NET source: >- using System; using System.Text.Json; using Didit; // Reads DIDIT_API_KEY. using var client = new DiditClient(); var result = await client.Sessions.RegenerateKybPartyAsync("33333333-4444-5555-6666-777777777777", "0a3f1e2c-7c2f-4a1b-9d55-2f8d2a5d6b41"); Console.WriteLine(JsonSerializer.Serialize(result)); components: schemas: KYBKeyPeopleParty: type: object description: >- 하위 인증을 포함하는 기업 확인(KYB) 세션의 주요 인물 당사자입니다. 동일한 당사자가 기업 세션 결정의 `key_people_checks[].submitted.parties[]`에 나타납니다. required: - uuid - entity_type - source - name - is_active - is_skipped - requires_verification - roles - kyc_session_deleted - kyb_sub_session_deleted properties: uuid: type: string format: uuid description: 당사자 식별자입니다. entity_type: type: string enum: - person - company description: 해당 당사자가 개인인지 기업인지 여부입니다. source: type: string enum: - REGISTRY - USER description: '`REGISTRY`: 법인 등기부에서 가져옴. `USER`: 주요 인물 화면에서 입력함.' name: type: string description: 당사자의 표시 이름입니다. first_name: type: string nullable: true description: 이름(개인). last_name: type: string nullable: true description: 성(개인). company_name: type: string nullable: true description: 기업명(기업 당사자). registration_number: type: string nullable: true description: 기업 등록번호(기업 당사자). email: type: string format: email nullable: true description: 인증 링크가 전송되는 이메일입니다. nationality: type: string nullable: true description: 개인의 경우 국적, 기업의 경우 법인 설립 국가입니다. phone_number: type: string nullable: true description: 해당 주체에 대해 수집된 전화번호입니다. date_of_birth: type: string format: date nullable: true description: 생년월일(개인)입니다. position: type: string nullable: true description: 자유 형식 직함입니다(개인). custom_fields: type: object additionalProperties: true description: 당사자에 대해 수집된 워크플로 정의 커스텀 필드이며, 필드 키를 키로 사용합니다. is_active: type: boolean description: 해당 당사자가 활성 상태인지 여부입니다. is_skipped: type: boolean description: 해당 당사자가 인증 면제 대상인지 여부입니다. 재생성하면 초기화됩니다. requires_verification: type: boolean description: 역할 및 소유 구조 규칙에 따라 이 당사자에 대한 인증이 필요한지 여부입니다. roles: type: array description: 해당 당사자가 회사에서 보유한 역할. items: type: object required: - role - ownership_percent - voting_percent properties: role: type: string enum: - director - non_executive_director - secretary - chairman - ubo - shareholder - representative - founder - legal_advisor - authorized_signatory - trustee - beneficiary - settlor - protector - company_officer - investor - other description: 역할 코드. ownership_percent: type: number nullable: true description: 알려진 경우, 이 역할의 소유 비율입니다. voting_percent: type: number nullable: true description: 알려진 경우 이 역할에 대한 의결권 비율입니다. kyc_session_id: type: string format: uuid nullable: true description: 하위 개인 KYC 세션(개인)입니다. kyc_session_status: type: string nullable: true enum: - Not Started - In Progress - Approved - Declined - In Review - Expired - Abandoned - Kyc Expired - Resubmitted - Awaiting User - null description: 하위 KYC 세션의 상태입니다. 삭제된 세션은 삭제 당시의 상태를 유지합니다. kyc_session_url: type: string format: uri nullable: true description: >- 하위 KYC 세션의 호스팅 링크입니다. 세션이 없거나 삭제된 경우, 그리고 `sessions: write` 권한이 없는 범위 지정 API 키의 경우 `null`입니다. kyc_session_deleted: type: boolean description: 하위 KYC 세션이 삭제되어 완료될 수 없습니다. kyb_sub_session_id: type: string format: uuid nullable: true description: 하위 KYB 세션(법인 당사자)입니다. kyb_sub_session_status: type: string nullable: true enum: - Not Started - In Progress - Approved - Declined - In Review - Expired - Abandoned - Kyc Expired - Resubmitted - Awaiting User - null description: 하위 KYB 세션의 상태입니다. kyb_sub_session_url: type: string format: uri nullable: true description: 하위 KYB 세션의 호스팅 링크이며, `kyc_session_url`과 동일한 `null` 규칙이 적용됩니다. kyb_sub_session_deleted: type: boolean description: '`kyc_session_deleted`에 대응하는 기업 당사자 이벤트입니다.' verification_workflow_type: type: string nullable: true enum: - kyc - kyb - adaptive_age_verification - biometric_authentication - address_verification - questionnaire_verification - email_verification - phone_verification - null description: 하위 세션이 실행하는 워크플로 유형입니다. verification_workflow_id: type: string format: uuid nullable: true description: 하위 세션이 실행하는 워크플로입니다. verification_workflow_label: type: string nullable: true description: 해당 워크플로의 라벨입니다. verification_workflow_features: type: array nullable: true description: 현재 상태가 포함된 하위 세션 워크플로의 기능입니다. items: type: object required: - feature - status properties: feature: type: string description: '기능 코드(예: `ID_VERIFICATION` 또는 `LIVENESS`).' status: type: string description: 실행될 때까지 `Not Finished`인 기능 상태입니다. didit_internal_id: type: string format: uuid nullable: true description: 인증된 인물이 확인된 경우 해당 인물에 대한 Didit의 식별자입니다. securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- Business Console의 Developers -> API keys에서 발급받은 귀하 애플리케이션의 API 키입니다. 기본 키는 전체 접근 권한을 갖습니다. 이름이 지정된 키는 리소스별 none, read, write 범위로 권한을 제한할 수 있으며 특정 워크플로나 승인된 세션, IP 주소 목록, 만료일 등으로 제한할 수도 있습니다. 401은 키가 잘못되었거나 폐기되었거나 만료되었음을 의미합니다. 403은 키가 전송되지 않았거나, 키에 해당 리소스나 작업에 대한 접근 권한이 없거나, 요청이 허용된 IP 목록 외부 주소에서 발생했음을 의미합니다. 세션 경로에서의 404는 해당 세션이 키의 허용 워크플로 또는 상태 범위를 벗어났음을 의미합니다. 미디어 접근 권한이 없는 키는 이미지, 비디오, PDF URL을 null로 수신하며, 세션 write 권한이 없는 키는 세션 링크와 token을 null로 수신합니다. https://docs.didit.me/console/api-keys 를 참고하십시오. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.