Update a single brand identity

PATCH

https://api.usenotra.com

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>"
  }
}

{
  "error": "<string>",
  "code": "<string>",
  "recovery": "<string>"
}

{
  "error": "<string>",
  "code": "<string>",
  "recovery": "<string>"
}

{
  "error": "<string>",
  "code": "<string>",
  "recovery": "<string>"
}

{
  "error": "<string>",
  "code": "<string>",
  "recovery": "<string>"
}

{
  "error": "<string>",
  "code": "<string>",
  "recovery": "<string>"
}

{
  "error": "<string>",
  "code": "<string>",
  "recovery": "<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

Pattern: ^[A-Za-z0-9_-]{1,100}$

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

Required string length: 1 - 200

Example:

"Notra"

companyDescription

string | null

Required string length: 10 - 4000

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.

Maximum string length: 1000

Example:

"Clear, direct, and technically confident"

customInstructions

string | null

Maximum string length: 4000

Example:

"Avoid hype. Prioritize concrete examples."

audience

string | null

Required string length: 10 - 1000

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

Show child attributes

brandIdentity

object

required

Show child attributes

Last modified on July 16, 2026

Delete a single brand identityDeletes a non-default brand identity and disables any automation triggers that reference it.

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>"
  }
}

{
  "error": "<string>",
  "code": "<string>",
  "recovery": "<string>"
}

{
  "error": "<string>",
  "code": "<string>",
  "recovery": "<string>"
}

{
  "error": "<string>",
  "code": "<string>",
  "recovery": "<string>"
}

{
  "error": "<string>",
  "code": "<string>",
  "recovery": "<string>"
}

{
  "error": "<string>",
  "code": "<string>",
  "recovery": "<string>"
}

{
  "error": "<string>",
  "code": "<string>",
  "recovery": "<string>"
}

Getting Started

Guides

Webhooks

Endpoints

Authorizations

Path Parameters

Body

Response