Skip to content
/
Delete a contract version

LegalOn API (1.3.1)

API documentation for LegalOn services

Languages
Servers
The server URL is `{api_base_url}/rest/v1`. You can construct the server URL using the value of `api_base_url` provided in the response when obtaining an access token.
https://{api_base_url_without_scheme}/rest/v1

Users

Operations about user

Operations

User Groups

Operations about user group

Operations

Workspaces

Operations about all tenant workspaces/folders regardless of the user's access permissions.

Operations

Departments

Operations about department

Operations

Contracts(Files)

Operations to create, retrieve, update, and delete contracts. For operations that target a workspace, specify a workspace_id obtained via the common Workspaces endpoint (GET /workspaces).

Operations

Update contract information

Request

Updates information about the specified contract version.

Security
OAuth2ClientCredentials
Path
document_idstring(uuid)required

Contract document ID

document_version_idstring(uuid)required

Contract version ID

Bodyapplication/jsonrequired

Update contract information request payload

metadataobject(update_contract_metadata_request)required

Contract metadata update request payload. This schema accepts metadata fields updated by the document metadata update source and document_status_code.

  • Omit document_status_code to keep the current status.
  • Set NONE to clear the current status.
metadata.​titlestring[ 1 .. 150 ] characters

Contract title

metadata.​language_codestring[ 2 .. 35 ] characters

Contract language code

metadata.​contract_category_positionsArray of objects(contract_category_position)

Contract category, position, and governing law classifications

metadata.​own_partiesArray of strings(party)

Own party names

metadata.​counter_partiesArray of strings(party)

Counter party names

metadata.​document_status_codestring(document_status_code)

Contract document status code for pre-execution contracts. NONE represents no document status.

Enum"COUNTERPARTY_DRAFT""INTERNAL_DRAFT""COUNTERPARTY_REVISION""INTERNAL_REVISION""APPROVED_VERSION""READY_FOR_SIGNATURE""NONE"
curl -i -X PATCH \
  'https://{api_base_url_without_scheme}/rest/v1/contracts/{document_id}/versions/{document_version_id}' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "metadata": {
      "title": "Confidentiality Agreement",
      "language_code": "en",
      "own_parties": [
        "LegalOn Technologies, Inc."
      ],
      "counter_parties": [
        "Example Corp."
      ],
      "contract_category_positions": [
        {
          "category_code": "NDA",
          "position_code": "discloser",
          "governing_law_code": "JP"
        }
      ],
      "document_status_code": "INTERNAL_DRAFT"
    }
  }'

Responses

OK

Bodyapplication/json
document_idstring(uuid)required

Contract document ID

document_version_idstring(uuid)required

Updated contract document version ID

version_numberinteger>= 1required

Version number in the current version list order

updated_atstring(date-time)required

Contract document latest update timestamp

titlestring[ 1 .. 1000 ] characters

Contract title

language_codestring[ 2 .. 35 ] characters

Contract language code

document_status_codestring(document_status_code)

Contract document status code for pre-execution contracts. NONE represents no document status.

Enum"COUNTERPARTY_DRAFT""INTERNAL_DRAFT""COUNTERPARTY_REVISION""INTERNAL_REVISION""APPROVED_VERSION""READY_FOR_SIGNATURE""NONE"
own_partiesArray of strings(party)

Own party names

counter_partiesArray of strings(party)

Counter party names

contract_category_positionsArray of objects(contract_category_position)

Contract category, position, and governing law classifications

Response
application/json
{
  "document_id": "00000016-0000-0000-0001-100000000001",
  "document_version_id": "00000016-0000-0000-0001-100000000101",
  "version_number": 3,
  "updated_at": "2026-05-08T03:13:20Z",
  "title": "Confidentiality Agreement",
  "language_code": "en",
  "document_status_code": "INTERNAL_DRAFT",
  "own_parties": [
    "LegalOn Technologies, Inc."
  ],
  "counter_parties": [
    "Example Corp."
  ],
  "contract_category_positions": [
    { … }
  ]
}

Delete a contract version

Request

Deletes the specified contract version.

Security
OAuth2ClientCredentials
Path
document_idstring(uuid)required

Contract document ID

document_version_idstring(uuid)required

Contract version ID

curl -i -X DELETE \
  'https://{api_base_url_without_scheme}/rest/v1/contracts/{document_id}/versions/{document_version_id}' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

No Content

Response
No content

Link an existing non-contract file to a contract

Request

Links an existing non-contract related file to the specified contract. The related file can be created with POST /files and can also be linked to a matter.

Security
OAuth2ClientCredentials
Path
document_idstring(uuid)required

Contract document ID

Bodyapplication/jsonrequired

Existing file link request payload

related_file_idstring(uuid)required

Non-contract related file ID to link. The same ID is returned as related_file_id in the success response and is used by unlink operations.

curl -i -X POST \
  'https://{api_base_url_without_scheme}/rest/v1/contracts/{document_id}/related-file-links' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "related_file_id": "00000016-0000-0000-0001-100000000301"
  }'

Responses

OK

Bodyapplication/json
document_idstring(uuid)required

Contract document ID

related_file_idstring(uuid)required

Non-contract related file ID

Response
application/json
{
  "document_id": "00000016-0000-0000-0001-100000000001",
  "related_file_id": "00000016-0000-0000-0001-100000000301"
}

Matters

Operations to create, retrieve, update, and delete matters. Matter operations require an API credential owned by a user with a Matter Management Pro license.

Operations

Files

Operations to create and manage files for LegalOn resources.

Operations

Workspaces

Workspaces/folders are the common units used to store and organize resources such as contracts.

Operations