POST /public/v1/writing-styles

Create a new writing style (status: PENDING). Populate dos and donts now or later via PATCH /public/v1/writing-styles/:id. A writing style needs rules before it can be linked to a campaign.

Required: workspaceId, name

Optional: dos, donts, connectInstructions, inmailInstructions, qna, templateName, templateFollowUpConfig, accessScope

accessScope:

OWNER (default) — private to the authenticated user
WORKSPACE — shared across the workspace; only ADMIN or OWNER members can set this

POST /public/v1/writing-styles

API key in header x-api-key

curl --request POST \
  --url 'https://api.joinvalley.co/public/v1/writing-styles' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "key": "value"
}'

{
  "statusCode": 1,
  "status": true,
  "message": "example",
  "data": {
    "writing_style": {
      "id": "id_01JXY9AZK4KV",
      "name": "example",
      "status": "example",
      "access_scope": "example",
      "created_at": "2026-01-01T12:00:00Z"
    }
  }
}

Default Response

Body

required application/json

workspaceId string · min length: 1 required

ID of the workspace to create the writing style in.

name string · min length: 1· max length: 255 required

Display name for the writing style.

dos array of string

List of things the AI should do when writing in this style.

donts array of string

List of things the AI should avoid when writing in this style.

connectInstructions string

Type any custom instructions here — tone preferences, message length guidelines, personalization rules, or any other direction for how your connect sequences should be written.

inmailInstructions string

Type any custom instructions here — tone preferences, message length guidelines, personalization rules, or any other direction for how your InMail sequences should be written.

qna array of object

Optional Q&A pairs that give the AI additional context about your tone and preferences.

templateName string

Optional template label (e.g. "Executive", "Startup") used to categorise the style.

Body

Responses