Developers/Applications

Enterprise identities

Register governed integrations

Create organization-owned confidential applications with explicit scopes, team workspace grants, service credentials, webhooks, usage controls, and audit history.

Ownership model

Organization, application, workspace

01OrganizationDefines enterprise ownership, members, roles, status, and application policy.
02ApplicationReceives a stable client ID and only the approved OAuth scopes it needs.
03Workspace grantsRestrict service access to selected non-personal team workspaces.
04CredentialAuthenticates the service without replacing DocIntel's live authorization checks.

Create an application

Configure least privilege first

Select the owning organizationUse a descriptive application nameSelect only required scopesGrant explicit team workspacesStore the one-time secret in a secret managerTest identity and workspace isolation
Personal workspaces are user contexts

Organization service applications use explicitly granted team workspaces. A workspace identifier narrows access but never grants it by itself.

Common service scopes

Build access incrementally

CapabilityTypical scopes
Discoveryworkspaces:read documents:read
Knowledgeknowledge:query knowledge:generate sessions:write
Ingestiondocuments:write
Batch operationsbatches:read batches:write
Vertical workflowsworkflows:read workflows:write
Knowledge Academylearning:read learning:participate learning:manage
Eventsevents:write

A scope allows a capability. Organization status, application status, workspace grant, membership, role, course persona, and resource ownership are enforced separately.

Lifecycle

Operate without sharing permanent credentials

Edit access

Add or remove approved scopes and workspaces. New access requires a newly issued token.

Request scopes

Request an unassigned scope with a business reason and route it to DocIntel administration for approval.

Rotate credentials

Create a new one-time secret while older active secrets remain valid for a bounded overlap.

Restrict issuance

Optionally permit Client Credentials token requests only from configured IPv4 or IPv6 CIDRs.

Audit changes

Review application creation, access updates, scope decisions, rotations, revocations, and suspension events.

Suspend safely

Block service access without deleting organization configuration or historical evidence.