Create a Matter

Redline API›Matters

POSThttps://api.redline.example/v1/matters

AuthRequires authentication via bearerAuth.

Description

Creates a contract negotiation thread in the authenticated Workspace.

Request

cURLJavaScriptPython

Copy

curl -X POST "https://api.redline.example/v1/matters" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Aster Peak services agreement",
  "agreement_type": "Master services agreement",
  "counterparty_name": "Aster Peak Systems, Inc.",
  "owner_id": "usr_01J9M4X8D2",
  "template_id": "tpl_01J8TR5A6P",
  "target_signature_date": "2026-08-28",
  "external_reference": "deal_84217"
}'

const response = await fetch("https://api.redline.example/v1/matters", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
      "name": "Aster Peak services agreement",
      "agreement_type": "Master services agreement",
      "counterparty_name": "Aster Peak Systems, Inc.",
      "owner_id": "usr_01J9M4X8D2",
      "template_id": "tpl_01J8TR5A6P",
      "target_signature_date": "2026-08-28",
      "external_reference": "deal_84217"
    }),
});

import requests

response = requests.post(
    "https://api.redline.example/v1/matters",
    headers={
      "Authorization": "Bearer YOUR_TOKEN"
    },
    json={
      "name": "Aster Peak services agreement",
      "agreement_type": "Master services agreement",
      "counterparty_name": "Aster Peak Systems, Inc.",
      "owner_id": "usr_01J9M4X8D2",
      "template_id": "tpl_01J8TR5A6P",
      "target_signature_date": "2026-08-28",
      "external_reference": "deal_84217"
    },
)

Response201JSONCopy

{
  "id": "mat_01JAZ6Q7K2",
  "name": "Aster Peak services agreement",
  "agreement_type": "Master services agreement",
  "counterparty_name": "Aster Peak Systems, Inc.",
  "status": "draft",
  "owner_id": "usr_01J9M4X8D2",
  "template_id": "tpl_01J8TR5A6P",
  "target_signature_date": "2026-08-28",
  "external_reference": "deal_84217",
  "current_turn_number": 3,
  "executed_copy_id": null,
  "created_at": "2024-01-01T00:00:00Z",
  "updated_at": "2024-01-01T00:00:00Z"
}

Request body

application/jsonrequired

namebodystringrequired

agreement_typebodystringrequired

counterparty_namebodystringrequired

owner_idbodystringrequired

template_idbodystring

target_signature_datebodystring <date>

external_referencebodystring

Responses

201The created Matter.application/json

idstringrequired

Stable Matter identifier

namestringrequired

Human-readable Matter name

agreement_typestringrequired

Workspace-defined contract category

counterparty_namestringrequired

Other contracting party

statusstringrequired

Current lifecycle state of a Matter.

owner_idstringrequired

Workspace member responsible for the Matter

template_idstring | null

Template used for the first draft

target_signature_datestring | null

Internal target for signature

external_referencestring | null

Identifier from a connected business system

current_turn_numberinteger

Latest completed Turn number

executed_copy_idstring | null

Final signed document when execution is complete

created_atstring <date-time>required

Creation timestamp.

updated_atstring <date-time>required

Most recent update timestamp.

401The API key is missing, malformed, expired, or revoked.application/json

errorobjectrequired

403The API key does not have permission for this action.application/json

errorobjectrequired

422One or more request fields are invalid.application/json

errorobjectrequired