Skip to main content
PATCH
https://api.usenotra.com
/
v1
/
brand-identities
/
{brandIdentityId}
curl --request PATCH \ --url https://api.usenotra.com/v1/brand-identities/{brandIdentityId} \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data ' { "isDefault": true } '
{
  "organization": {
    "id": "<string>",
    "slug": "<string>",
    "name": "<string>",
    "logo": "<string>"
  },
  "brandIdentity": {
    "id": "<string>",
    "name": "<string>",
    "isDefault": true,
    "websiteUrl": "<string>",
    "companyName": "<string>",
    "companyDescription": "<string>",
    "toneProfile": "<string>",
    "customTone": "<string>",
    "customInstructions": "<string>",
    "audience": "<string>",
    "language": "<string>",
    "createdAt": "<string>",
    "updatedAt": "<string>"
  }
}

Authorizations

​
Authorization
string
header
required

Send your API key in the Authorization header as Bearer API_KEY.

Path Parameters

​
brandIdentityId
string
required
Minimum string length: 1
Example:

"51c2f3aa-efdd-4e28-8e69-23fa2dfd3561"

Body

application/json
​
name
string
Required string length: 1 - 120
Example:

"Notra"

​
websiteUrl
string
Minimum string length: 1
Example:

"https://usenotra.com"

​
companyName
string | null
Minimum string length: 1
Example:

"Notra"

​
companyDescription
string | null
Minimum string length: 10
Example:

"AI-native content workflows for software teams."

​
toneProfile
enum<string> | null

Set a preset tone profile. When provided without customTone, any saved custom tone is cleared.

Available options:
Conversational,
Professional,
Casual,
Formal,
null
Example:

"Professional"

​
customTone
string | null

Provide a custom tone override. Send an empty string or null to clear it.

Example:

"Clear, direct, and technically confident"

​
customInstructions
string | null
Example:

"Avoid hype. Prioritize concrete examples."

​
audience
string | null
Minimum string length: 10
Example:

"Engineering leaders and developer tooling teams."

​
language
enum<string> | null
Available options:
English,
Spanish,
French,
German,
Portuguese,
Dutch,
Italian,
Japanese,
Korean,
Chinese,
Arabic,
Hindi,
Russian,
Turkish,
Polish,
Swedish,
Danish,
Norwegian,
Finnish,
Czech,
Romanian,
Hungarian,
Greek,
Thai,
Vietnamese,
Indonesian,
Ukrainian,
Hebrew,
null
Example:

"English"

​
isDefault
enum<boolean>

Set this brand identity as the organization's default. Only true is accepted.

Available options:
true
Example:

true

Response

Brand identity updated successfully

​
organization
object
required
​
brandIdentity
object
required