specification: Naftiko Capability
specificationVersion: '0.1'
id: alloy-entities
name: Alloy Entities
description: Manage person and business entities, merge entities, attach notes,
submit entity feedback, and look up entity groups. Entities are the central
identity record across Alloy's decisioning surface.
provider: Alloy
providerId: alloy
created: '2026-05-25'
modified: '2026-05-25'
tags:
- Identity
- Entities
- KYC
- KYB
operations:
- id: post-entity-person
summary: Create a Person Entity
method: POST
path: /entities/persons
- id: get-entity-person
summary: Get a Person Entity
method: GET
path: /entities/persons/{entity_token}
- id: patch-entity-person
summary: Update a Person Entity
method: PATCH
path: /entities/persons/{entity_token}
- id: post-entity-business
summary: Create a Business Entity
method: POST
path: /entities/businesses
- id: get-entity-business
summary: Get a Business Entity
method: GET
path: /entities/businesses/{entity_token}
- id: patch-entity-business
summary: Update a Business Entity
method: PATCH
path: /entities/businesses/{entity_token}
- id: post-entity-merge
summary: Merge Entities
method: POST
path: /entities/merge
- id: post-entity-note
summary: Add a Note to an Entity
method: POST
path: /entities/{entity_token}/notes
- id: get-entity-feedback
summary: List Entity Feedback
method: GET
path: /entity-feedback
- id: post-entity-feedback
summary: Submit Entity Feedback
method: POST
path: /entity-feedback
- id: get-entity-group
summary: Get Entity Group by Token or External ID
method: GET
path: /entity-groups/{entity_token_or_external_id}