Integration and acceptance.
Use test access for contract integration, bounded fixtures, error handling, and rollout verification before promotion.
Authentication
CorpusMesh issues private-beta credentials manually. Keys stay on your server and identify an API client; entitlements determine which immutable knowledge-base versions and profiles that client can retrieve.
Request authentication
Load the issued key from a server secret store and send it in the authorization header. Do not put it in a browser bundle, mobile application, URL, analytics property, log, or repository.
Read the key at runtime from a secret manager or protected environment variable.
The API key identifies your service client. Do not create one key per end user or send personal data in the key label.
Idempotency-Key identifies one retried request. It is not an authentication credential.
Authorization: Bearer cm_test_••••••••
Content-Type: application/json
Idempotency-Key: request-article-6-001Access resolution
The server verifies the keyed digest, environment, client status, organization status, scope, active entitlement, authorized corpus version, and selected retrieval profile.
A missing scope, revoked client, inactive organization, wrong environment, or unavailable entitlement stops the request before paid retrieval work.
Environment separation
The environment is part of the client boundary, not a naming convention. A test key cannot authenticate against live access, and a live key cannot be used for test fixtures.
Use test access for contract integration, bounded fixtures, error handling, and rollout verification before promotion.
Live credentials are issued separately only after the activation gate, entitlement, limits, and rollback path are approved.
Credential lifecycle
CorpusMesh records issuance, activation, rotation, revocation, and entitlement changes as auditable operations. A revoked key fails immediately.
Access boundary
Private-beta access is reviewed against the requested corpus, environment, filters, and expected request volume.