Skip to main content
POST
Create clause

Authorizations

x-api-key
string
header
required

API key for authentication. Get your key at https://app.tomorro.com/settings/integrations?integration=api-key

Body

application/json
name
string
required

Name of the clause in the organization Clause Library

Minimum string length: 1
Example:

"Governing Law"

description
string
required

Short description of the clause (may be an empty string)

Example:

"Standard governing law and jurisdiction wording"

contentText
string
required

Legal body of the clause (plain text or markdown). Converted server-side to Slate — markdown headings, bold/italic, and lists are preserved as editor nodes.

Minimum string length: 1
Example:

"This Agreement shall be governed by the laws of England and Wales."

language
string

Optional translation language code (e.g. fr, gb). Defaults to the organization language when omitted or invalid.

Example:

"gb"

Response

Clause created successfully

id
string
required

Unique identifier for the clause.

Example:

"550e8400-e29b-41d4-a716-446655440000"

name
string
required

The name of the clause.

Example:

"Confidentiality"

description
string
required

A short description of the clause.

Example:

"Standard confidentiality clause"

organizationId
string
required

The organization this clause belongs to.

Example:

"550e8400-e29b-41d4-a716-446655440000"

content
object[]
required

The raw JSON content of the clause (Slate editor format).

Example:
contentText
string
required

Plain-text rendering of content (Slate → text). Prefer this for LLM / text consumers; use content for rich editing.

Example:

"Clause content"

listNumbering
object | null
required

List numbering configuration, if any.

Example:

null

translations
object[]
required

Per-language translations of the clause.

Example:
languages
string[]
required

Languages available for this clause.

Example:
createdAt
string<date-time>
required

Time at which the clause was created. Formatted as an ISO 8601 date-time string.

Example:

"2024-01-01T00:00:00.000Z"

updatedAt
string<date-time>
required

Time at which the clause was last updated. Formatted as an ISO 8601 date-time string.

Example:

"2024-01-02T00:00:00.000Z"