generated: '2026-07-15' method: generated source: openapi/core-v2-openapi.yml, openapi/kyc-v2-openapi.json description: Recommended x-agentic-access execution contracts, classified heuristically from the OpenAPI. A governance starting point for exposing this API to AI agents — review and bind audience per deployment. See research/curity/agentic-governance/. summary: operations: 52 by_action_class: connected: 14 acting: 38 by_consequence: read: 14 write: 36 safety-critical: 1 physical: 1 human_in_the_loop_required: 1 operations: - path: /v2/audit method: get operationId: listAuditEvents x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v2/workflows method: get operationId: getWorkflows x-agentic-access: action-class: connected consequence: read subject: optional scope: - kyc:api token: max-ttl: 3600 audit: none - path: /v2/search/serviceprofiles method: post operationId: searchProfiles x-agentic-access: action-class: acting consequence: write subject: required scope: - kyc:api audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v2/search/matchlists method: post operationId: searchMatchlists x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v2/matchlists method: get operationId: getMatchlist x-agentic-access: action-class: connected consequence: read subject: optional scope: - kyc:api token: max-ttl: 3600 audit: none - path: /v2/matchlists/{matchlistName}/entries method: post operationId: createMatchlistEntry x-agentic-access: action-class: acting consequence: write subject: required scope: - kyc:api audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v2/matchlists/{matchlistName}/entries method: get operationId: getMatchlistEntries x-agentic-access: action-class: connected consequence: read subject: optional scope: - kyc:api token: max-ttl: 3600 audit: none - path: /v2/matchlists/{matchlistName}/entries/{entryId} method: patch operationId: updateMatchlistEntry x-agentic-access: action-class: acting consequence: write subject: required scope: - kyc:api audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v2/matchlists/{matchlistName}/entries/{entryId} method: get operationId: getMatchlistEntry x-agentic-access: action-class: connected consequence: read subject: optional scope: - kyc:api token: max-ttl: 3600 audit: none - path: /v2/matchlists/{matchlistName}/entries/addEntity method: post operationId: addMatchlistEntity x-agentic-access: action-class: acting consequence: write subject: required scope: - kyc:api audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v2/matchlists/{matchlistName}/entries/removeEntity method: patch operationId: removeMatchlistEntity x-agentic-access: action-class: acting consequence: write subject: required scope: - kyc:api audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v2/individuals method: post operationId: createIndividuals x-agentic-access: action-class: acting consequence: write subject: required scope: - kyc:api audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v2/individuals/{entityId} method: patch operationId: updateIndividual x-agentic-access: action-class: acting consequence: write subject: required scope: - kyc:api audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v2/individuals/{entityId} method: get operationId: getIndividual x-agentic-access: action-class: connected consequence: read subject: optional scope: - kyc:api token: max-ttl: 3600 audit: none - path: /v2/individuals/{entityId} method: delete operationId: deleteIndividual x-agentic-access: action-class: acting consequence: write subject: required scope: - kyc:api audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v2/workflows method: get operationId: getWorkflows x-agentic-access: action-class: connected consequence: read subject: optional scope: - kyc:api token: max-ttl: 3600 audit: none - path: /v2/individuals/new/serviceprofiles/{serviceName}/workflows/{workflowName}/execute method: post operationId: createAndExecuteWorkflow x-agentic-access: action-class: acting consequence: write subject: required scope: - kyc:api audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v2/individuals/{entityId}/serviceprofiles/{serviceName}/workflows/{workflowName}/execute method: post operationId: executeWorkflow x-agentic-access: action-class: acting consequence: write subject: required scope: - kyc:api audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v2/individuals/{entityId}/serviceprofiles/{serviceName}/workflows/{workflowName}/executions method: get operationId: getResults x-agentic-access: action-class: connected consequence: read subject: optional scope: - kyc:api token: max-ttl: 3600 audit: none - path: /v2/individuals/{entityId}/serviceprofiles/{serviceName}/workflows/{workflowName}/executions/{workflowExecutionId} method: get operationId: getWorkflowExecutionResult x-agentic-access: action-class: connected consequence: read subject: optional scope: - kyc:api token: max-ttl: 3600 audit: none - path: /v2/individuals/{entityId}/serviceprofiles/{serviceName}/workflows/{workflowName}/executions/{workflowExecutionId} method: patch operationId: overrideWorkflowExecutionResult x-agentic-access: action-class: acting consequence: safety-critical subject: required scope: - kyc:api audience: null token: max-ttl: 120 exchange: true purpose-required: true proof-of-possession: true escalation: human-in-the-loop: required audit: required - path: /v2/individuals/{entityId}/serviceprofiles/{serviceName} method: patch operationId: updateProfile x-agentic-access: action-class: acting consequence: write subject: required scope: - kyc:api audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v2/individuals/{entityId}/serviceprofiles/{serviceName} method: get operationId: getProfile x-agentic-access: action-class: connected consequence: read subject: optional scope: - kyc:api token: max-ttl: 3600 audit: none - path: /v2/individuals/{entityId}/results/mkyc method: post operationId: manualKYC x-agentic-access: action-class: acting consequence: write subject: required scope: - kyc:api audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v2/individuals/{entityId}/results/mkyc/invalidate method: post operationId: manualKYCinvalidation x-agentic-access: action-class: acting consequence: write subject: required scope: - kyc:api audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v2/individuals/{entityId}/results/aml method: patch operationId: updateAML x-agentic-access: action-class: acting consequence: write subject: required scope: - kyc:api audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v2/individuals/{entityId}/results/idv method: patch operationId: updateIDV x-agentic-access: action-class: acting consequence: write subject: required scope: - kyc:api audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v2/individuals/{entityId}/results/matchlist method: patch operationId: updateMatches x-agentic-access: action-class: acting consequence: write subject: required scope: - kyc:api audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v2/individuals/{entityId}/results/duplicate method: patch operationId: updateDuplicate x-agentic-access: action-class: acting consequence: write subject: required scope: - kyc:api audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v2/individuals/{entityId}/results/fraud method: patch operationId: updateFraud x-agentic-access: action-class: acting consequence: write subject: required scope: - kyc:api audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v2/individuals/{entityId}/results method: get operationId: getAllPROs x-agentic-access: action-class: connected consequence: read subject: optional scope: - kyc:api token: max-ttl: 3600 audit: none - path: /v2/individuals/{entityId}/names/{nameId} method: delete operationId: deleteName x-agentic-access: action-class: acting consequence: write subject: required scope: - kyc:api audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v2/individuals/{entityId}/datesOfBirth/{dateOfBirthId} method: delete operationId: deleteDob x-agentic-access: action-class: acting consequence: write subject: required scope: - kyc:api audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v2/individuals/{entityId}/addresses/{addressId} method: delete operationId: deleteAddress x-agentic-access: action-class: acting consequence: write subject: required scope: - kyc:api audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v2/individuals/{entityId}/emailaddresses/{emailAddressId} method: delete operationId: deleteEmailAddress x-agentic-access: action-class: acting consequence: write subject: required scope: - kyc:api audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v2/individuals/{entityId}/phonenumbers/{phoneNumberId} method: delete operationId: deletePhoneNumber x-agentic-access: action-class: acting consequence: write subject: required scope: - kyc:api audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v2/individuals/{entityId}/consents/{consentType} method: delete operationId: deleteConsent x-agentic-access: action-class: acting consequence: physical subject: required scope: - kyc:api audience: null token: max-ttl: 300 exchange: true purpose-required: true escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v2/individuals/{entityId}/externalreferences method: get operationId: getExternalReference x-agentic-access: action-class: connected consequence: read subject: optional scope: - kyc:api token: max-ttl: 3600 audit: none - path: /v2/individuals/{entityId}/externalreferences/{referenceId} method: delete operationId: deleteExternalReference x-agentic-access: action-class: acting consequence: write subject: required scope: - kyc:api audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v2/search/serviceprofiles method: post operationId: searchIndividuals x-agentic-access: action-class: acting consequence: write subject: required scope: - kyc:api audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v2/individuals/{entityId}/documents method: post operationId: createDocuments x-agentic-access: action-class: acting consequence: write subject: required scope: - kyc:api audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v2/individuals/{entityId}/documents method: get operationId: getDocuments x-agentic-access: action-class: connected consequence: read subject: optional scope: - kyc:api token: max-ttl: 3600 audit: none - path: /v2/individuals/{entityId}/documents/{documentId} method: patch operationId: updateDocument x-agentic-access: action-class: acting consequence: write subject: required scope: - kyc:api audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v2/individuals/{entityId}/documents/{documentId} method: get operationId: getDocument x-agentic-access: action-class: connected consequence: read subject: optional scope: - kyc:api token: max-ttl: 3600 audit: none - path: /v2/individuals/{entityId}/documents/{documentId} method: delete operationId: deleteDocument x-agentic-access: action-class: acting consequence: write subject: required scope: - kyc:api audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v2/individuals/{entityId}/documents/{documentId}/attachments/{attachmentId} method: delete operationId: deleteAttachments x-agentic-access: action-class: acting consequence: write subject: required scope: - kyc:api audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v2/individuals/{entityId}/serviceprofiles/{serviceName}/risk method: patch operationId: updateIndividualRiskLevel x-agentic-access: action-class: acting consequence: write subject: required scope: - kyc:api audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v2/individuals/{entityId}/monitor method: patch operationId: patchMonitoring x-agentic-access: action-class: acting consequence: write subject: required scope: - kyc:api audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v2/individuals/{entityId}/actions/idv/token method: post operationId: getIDVToken x-agentic-access: action-class: acting consequence: write subject: required scope: - kyc:api audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v2/individuals/{entityId}/actions/idv/ocr method: post operationId: processIDVOCR x-agentic-access: action-class: acting consequence: write subject: required scope: - kyc:api audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v2/individuals/{entityId}/actions/idv/process method: post operationId: initBiometrics x-agentic-access: action-class: acting consequence: write subject: required scope: - kyc:api audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v2/individuals/hostedurl method: post operationId: getHostedUrl x-agentic-access: action-class: acting consequence: write subject: required scope: - kyc:api audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required