Digitalyser.io for developers
API referenceEditorial

Brand voice settings

The project's brand voice: active style, form of address, technical level, language, and per-channel overrides.

The project's brand voice: active style, form of address, technical level, language, and per-channel overrides.

configured and enabled say different things: a voice can be defined and switched off. Reading one for the other would apply a style the project has deliberately disabled.

GET/v1/projects/{projectId}/brand-voice

Authorization

agent-token
AuthorizationBearer <token>

An agent project token. Obtained by OAuth consent for an AI client, or derived per project from an organisation service key for a machine. A scoped API key authenticates the transport but opens no capability: a capability takes its project from the credential.

In: header

Path Parameters

projectId*string

The project this call is about. A routing hint, not an authorisation. The project comes from the credential; this segment exists so multi-project code stays uniform. If it names a project outside the token, the call is refused with routing_hint_mismatch.

Formatuuid

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://app.digitalyser.io/api/v1/projects/550e8400-e29b-41d4-a716-446655440000/brand-voice" \  -H "Authorization: Bearer <token>"
{  "projectId": "8f14e45f-ea0e-4b1e-9b7a-2c3d4e5f6071",  "configured": true,  "enabled": true,  "activeStyleRef": "preset:pedagogique-clair",  "visualPolicy": {    "preference": "balanced"  },  "createdAt": "2026-09-02T14:31:07.000Z",  "updatedAt": "2026-09-18T09:12:44.000Z"}

Generated from the capability registry — API version 1, 18 paths, from 4815355 (2026-10-12).

Was this page helpful?