Core Concepts

Data Models

Learn about the core entities in Interna and how they relate to each other.

Entity Overview

Entity	Description	API Prefix
`User`	`An individual account holder`	`/v1/users`
`Organization`	`A company or team grouping`	`/v1/organizations`
`Permission`	`An access control rule`	`/v1/permissions`
`Role`	`A named set of permissions`	`/v1/roles`

Relationships

Users belong to organizations through memberships. Each membership assigns a role, and each role contains a set of permissions. This hierarchy enables fine-grained access control at every level.

Common Fields

All entities share a standard set of metadata fields:

Field	Type	Description
`id`	`string`	`Unique identifier with entity prefix (e.g. usr_, org_)`
`created_at`	`ISO 8601`	`Timestamp of creation`
`updated_at`	`ISO 8601`	`Timestamp of last update`
`metadata`	`object`	`Arbitrary key-value pairs for custom data`