Contracts
Every Contracts tool, with the scope it needs, its arguments and the API operation it calls.
43 tools
Get contract analytics
Read onlyatlas_contracts_analytics_get
Return contracts analytics overview - status mix, kind mix, active value by currency, 30/60/90-day expiring counts, and renewal rate.
- Scope
contracts:read- Calls
- Example prompt
- Give me the contract portfolio overview for this month.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
from | string (date-time) | No | Optional ISO-8601 lower bound for contract createdAt. |
to | string (date-time) | No | Optional ISO-8601 upper bound for contract createdAt. |
List contract approvals
Read onlyatlas_contracts_approvals_list
List the approval chain for a contract in sequence order with status and comments, one page at a time. Returns a nextCursor; pass it back as cursor for the next page.
- Scope
contracts:read- Calls
- Example prompt
- Who has approved contract con_xyz so far?
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
id | string | Yes | |
limit | integer | No | How many rows to return, 1 to 100. 50 by default. |
cursor | string | No | The nextCursor of the previous page. Leave it out for the first page. |
sort | "sequence" | No | The field to sort on: sequence. sequence by default. |
order | "asc" | "desc" | No | asc or desc. asc by default. |
Approve contracts
Changes dataatlas_contracts_approve
Record an approval on a contract under review with an optional comment.
- Scope
contracts:write- Calls
- Example prompt
- Approve contract con_xyz.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
id | string | Yes | |
comment | string | No |
Add contract approvers
Changes dataatlas_contracts_approvers_add
Add an approver to a contract with a sequence number and optional SLA in hours.
- Scope
contracts:write- Calls
- Example prompt
- Add legal as approver 1 on contract con_xyz with a 24h SLA.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
id | string | Yes | Contract id to attach the approver to. |
approverUserId | string | Yes | |
sequence | integer | Yes | |
slaHours | integer | No |
Archive contracts
Changes dataatlas_contracts_archive
Archive a contract (soft-hides it from the active list).
- Scope
contracts:write- Calls
- Example prompt
- Archive contract con_xyz.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
id | string | Yes |
List contract audit events
Read onlyatlas_contracts_audit_events_list
List the tamper-evident audit log for a contract in chronological order, one page at a time. Returns a nextCursor; pass it back as cursor for the next page.
- Scope
contracts:read- Calls
- Example prompt
- Show the audit trail for contract con_xyz.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
id | string | Yes | |
limit | integer | No | How many rows to return, 1 to 100. 50 by default. |
cursor | string | No | The nextCursor of the previous page. Leave it out for the first page. |
sort | "at" | No | The field to sort on: at. at by default. |
order | "asc" | "desc" | No | asc or desc. asc by default. |
Verify contract audit events
Read onlyatlas_contracts_audit_events_verify
Verify the hash-chain integrity of a contract audit log (returns { ok, brokenAt? } for tamper detection).
- Scope
contracts:read- Calls
- Example prompt
- Verify the audit chain on contract con_xyz.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
id | string | Yes |
Request contract changes
Changes dataatlas_contracts_changes_request
Request changes on a contract under review (with a required comment explaining the asks).
- Scope
contracts:write- Calls
- Example prompt
- Request changes on contract con_xyz: SLA must be 99.9.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
id | string | Yes | |
comment | string | Yes |
Add contract clauses
Changes dataatlas_contracts_clauses_add
Attach a library clause template to a specific contract.
- Scope
contracts:write- Calls
- Example prompt
- Attach the mutual-NDA clause to contract con_xyz.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
id | string | Yes | Contract id. |
clauseId | string | Yes | Clause template id from the library to attach. |
Create contract clauses
Changes dataatlas_contracts_clauses_create
Create a clause-library template (category, name, body, variables, risk level).
- Scope
contracts:write- Calls
- Example prompt
- Add a new mutual-NDA confidentiality clause to the library.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
category | string | Yes | |
name | string | Yes | |
body | string | Yes | |
variables | array of object | No | |
riskLevel | "safe" | "standard" | "negotiated" | No | |
language | string | No |
List contract clauses
Read onlyatlas_contracts_clauses_list
List clause-library templates, one page at a time. Optionally filter by category. Returns a nextCursor; pass it back as cursor for the next page.
- Scope
contracts:read- Calls
- Example prompt
- What clause templates do we have for indemnification?
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
category | string | No | |
limit | integer | No | How many rows to return, 1 to 100. 50 by default. |
cursor | string | No | The nextCursor of the previous page. Leave it out for the first page. |
sort | "lastUpdatedAt" | "name" | No | The field to sort on: lastUpdatedAt, name. lastUpdatedAt by default. |
order | "asc" | "desc" | No | asc or desc. desc by default. |
Update contract clauses
Changes dataatlas_contracts_clauses_update
Patch fields on a clause-library template.
- Scope
contracts:write- Calls
- Example prompt
- Update the standard liability clause body.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
id | string | Yes | |
patch | object | Yes | Fields to update on the clause template. |
Create contracts
Changes dataatlas_contracts_create
Create a new contract (lands in draft). Capture title, kind, counterparties, term, value and tags.
- Scope
contracts:write- Calls
- Example prompt
- Draft an MSA contract with Acme Corp, 12-month term.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
title | string | Yes | |
kind | "msa" | "sow" | "nda" | "dpa" | "employment" | "partnership" | "vendor" | "customer" | "other" | No | |
counterparties | array of object | No | |
valueAmount | number | No | |
valueCurrency | string | No | ISO-4217 currency code. |
startsOn | string (date-time) | No | |
endsOn | string (date-time) | No | |
renewalDate | string (date-time) | No | |
autoRenewing | boolean | No | |
renewalNoticeDays | integer | No | |
governingLaw | string | No | |
paymentTerms | string | No | |
terminationClause | string | No | |
tags | array of string | No |
Decline contracts
Changes dataatlas_contracts_decline
Decline an approval slot on a contract under review (with a required reason comment).
- Scope
contracts:write- Calls
- Example prompt
- Decline contract con_xyz: liability cap unacceptable.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
id | string | Yes | |
comment | string | Yes |
List contract expirations
Read onlyatlas_contracts_expirations_list
List active contracts expiring inside the given look-ahead window, soonest first, with days remaining and value.
- Scope
contracts:read- Calls
- Example prompt
- Which contracts expire in the next 60 days?
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
withinDays | integer | No | Look-ahead window in days. Defaults to 90. |
Submit contract external reviews
Changes dataatlas_contracts_external_reviews_submit
Move an internally approved contract into external review with the counterparty.
- Scope
contracts:write- Calls
- Example prompt
- Send contract con_xyz to the counterparty for review.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
id | string | Yes |
Get contracts
Read onlyatlas_contracts_get
Fetch a single contract by id, including counterparties, value, term dates, and current status.
- Scope
contracts:read- Calls
- Example prompt
- Show me contract con_xyz.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
id | string | Yes |
Submit contract internal reviews
Changes dataatlas_contracts_internal_reviews_submit
Move a draft contract into internal review (legal / finance sign-off pre-counterparty).
- Scope
contracts:write- Calls
- Example prompt
- Send contract con_xyz to internal review.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
id | string | Yes |
List contracts
Read onlyatlas_contracts_list
List contracts in the tenant, one page at a time. Filter by status, owner, kind, or full-text search across title and counterparties. Returns a nextCursor; pass it back as cursor for the next page.
- Scope
contracts:read- Calls
- Example prompt
- Which contracts are out for signature right now?
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
status | "draft" | "internal_review" | "external_review" | "out_for_signature" | "active" | "expired" | "terminated" | "archived" | No | |
ownerUserId | string | No | |
kind | "msa" | "sow" | "nda" | "dpa" | "employment" | "partnership" | "vendor" | "customer" | "other" | No | |
search | string | No | |
limit | integer | No | How many rows to return, 1 to 100. 50 by default. |
cursor | string | No | The nextCursor of the previous page. Leave it out for the first page. |
sort | "updatedAt" | "createdAt" | "title" | No | The field to sort on: updatedAt, createdAt, title. updatedAt by default. |
order | "asc" | "desc" | No | asc or desc. desc by default. |
Extract contract metadata
Changes dataatlas_contracts_metadata_extract
Re-run the AI metadata extractor on a contract (term dates, value, governing law, etc.). Returns the updated contract.
- Scope
contracts:write- Calls
- Example prompt
- Re-extract metadata for contract con_xyz.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
id | string | Yes |
Create contract obligations
Changes dataatlas_contracts_obligations_create
Create a new contract obligation (payment, deliverable, renewal, termination_notice, custom).
- Scope
contracts:write- Calls
- Example prompt
- Add a quarterly payment obligation to contract con_xyz.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
id | string | Yes | Contract id the obligation belongs to. |
kind | "payment" | "deliverable" | "renewal" | "termination_notice" | "custom" | Yes | |
dueDate | string (date-time) | Yes | |
description | string | Yes | |
assigneeUserId | string | No |
List contract obligations
Read onlyatlas_contracts_obligations_list
List obligations across all contracts, soonest due first, one page at a time. Filter by status or upcoming-due flag. Returns a nextCursor; pass it back as cursor for the next page.
- Scope
contracts:read- Calls
- Example prompt
- Which contract obligations are due in the next 30 days?
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
status | "open" | "met" | "breached" | "waived" | No | |
upcoming | boolean | No | |
limit | integer | No | How many rows to return, 1 to 100. 50 by default. |
cursor | string | No | The nextCursor of the previous page. Leave it out for the first page. |
sort | "dueDate" | No | The field to sort on: dueDate. dueDate by default. |
order | "asc" | "desc" | No | asc or desc. asc by default. |
Update contract obligations
Changes dataatlas_contracts_obligations_update
Patch a contract obligation: status (open/met/breached/waived), description, due date or assignee.
- Scope
contracts:write- Calls
- Example prompt
- Mark obligation obl_xyz as met.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
id | string | Yes | Obligation id. |
status | "open" | "met" | "breached" | "waived" | No | |
description | string | No | |
dueDate | string (date-time) | No | |
assigneeUserId | string | No |
Renew contracts
Changes dataatlas_contracts_renew
Renew an active contract in-place by setting a new end date (and optional new value).
- Scope
contracts:write- Calls
- Example prompt
- Renew contract con_xyz for another 12 months.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
id | string | Yes | |
newEndsOn | string (date-time) | Yes | ISO datetime of the new end of term. |
newValueAmount | number | No |
Accept contract renewals
Changes dataatlas_contracts_renewals_accept
Accept a sent renewal proposal (owner/admin only). Updates the underlying contract.
- Scope
contracts:write- Calls
- Example prompt
- Accept renewal rnw_xyz.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
id | string | Yes |
Create contract renewals
Changes dataatlas_contracts_renewals_create
Propose a renewal for an existing contract (new end date, optional new value, internal notes).
- Scope
contracts:write- Calls
- Example prompt
- Propose a 12-month renewal on contract con_xyz at 110k USD.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
contractId | string | Yes | |
newEndsOn | string (date-time) | Yes | Proposed new end-of-term datetime. |
newValueAmount | number | No | |
notes | string | No |
Get contract renewals
Read onlyatlas_contracts_renewals_get
Fetch a single contract renewal proposal by id.
- Scope
contracts:read- Calls
- Example prompt
- Show me renewal rnw_xyz.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
id | string | Yes |
List contract renewals
Read onlyatlas_contracts_renewals_list
List contract renewals. Use withinDays for the analytics feed (upcoming auto-renewals); otherwise filter renewal proposals by status or contract.
- Scope
contracts:read- Calls
- Example prompt
- Which contracts auto-renew in the next 60 days?
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
withinDays | integer | No | When set, returns contracts whose renewal/end falls within this many days (analytics feed). |
status | "PROPOSED" | "SENT" | "ACCEPTED" | "REJECTED" | "CANCELLED" | No | Filter the renewal proposal list by status. Ignored when withinDays is set. |
contractId | string | No | Filter the renewal proposal list to one contract. Ignored when withinDays is set. |
Reject contract renewals
Changes dataatlas_contracts_renewals_reject
Reject a sent renewal proposal with a required reason (owner/admin only).
- Scope
contracts:write- Calls
- Example prompt
- Reject renewal rnw_xyz: pricing not aligned.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
id | string | Yes | |
reason | string | Yes |
Send contract renewals
Destructiveatlas_contracts_renewals_send
Send a proposed renewal to the counterparty (transitions proposal to SENT).
- Scope
contracts:write- Calls
- Example prompt
- Send renewal rnw_xyz to the counterparty.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
id | string | Yes |
Request contract signatures
Changes dataatlas_contracts_signatures_request
Send an approved contract out for signature (transitions to out_for_signature).
- Scope
contracts:write- Calls
- Example prompt
- Send contract con_xyz out for signature.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
id | string | Yes |
Create contract suite
Changes dataatlas_contracts_suite_create
Create a contract record. Returns the created contract with status draft.
- Scope
contracts:write- Calls
- Example prompt
- Create a draft MSA contract for Acme.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
title | string | Yes | Short, human-readable contract title. |
kind | "msa" | "sow" | "nda" | "dpa" | "employment" | "partnership" | "vendor" | "customer" | "other" | No | Contract kind. Defaults to other. |
counterparties | array of object | No | Parties to the contract. Defaults to none. |
valueAmount | number | No | Contract value in major currency units (for example 12500.50), not cents. |
valueCurrency | string | No | ISO-4217 currency code for valueAmount. |
startsOn | string (date-time) | No | ISO-8601 date the contract takes effect. |
endsOn | string (date-time) | No | ISO-8601 date the contract ends. |
renewalDate | string (date-time) | No | ISO-8601 renewal date. |
autoRenewing | boolean | No | Whether the contract renews automatically. Defaults to false. |
renewalNoticeDays | integer | No | Days of notice needed before renewal. |
governingLaw | string | No | Governing law, for example "England and Wales". |
paymentTerms | string | No | Payment terms. |
terminationClause | string | No | Termination clause text. |
tags | array of string | No | Free-form tags. |
Submit contract suite internal reviews
Changes dataatlas_contracts_suite_internal_reviews_submit
Submit a contract for internal approval. Returns the contract with its approval-request id and routing state.
- Scope
contracts:write- Calls
- Example prompt
- Request approval for contract ctr_123.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
id | string | Yes | Contract id. |
approverIds | array of string | No | User ids to route the approval to. |
note | string | No | Optional note to approvers. |
Extract contract suite metadata
Changes dataatlas_contracts_suite_metadata_extract
Run AI metadata extraction over the contract body. Returns the extracted fields (parties, dates, value, renewal terms, etc.).
- Scope
contracts:write- Calls
- Example prompt
- Extract metadata from contract ctr_123.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
id | string | Yes | Contract id. |
fields | array of string | No | Optional allow-list of fields to extract (e.g. parties, effectiveDate, renewalTerms). |
Reject contract suite renewals
Changes dataatlas_contracts_suite_renewals_reject
Decline a proposed contract renewal. Notifies the requester and records the reason on the audit event. Returns the renewal with status: REJECTED.
- Scope
contracts:write- Calls
- Example prompt
- Decline renewal rnw_xyz - pricing out of band.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
id | string | Yes | Contract renewal id. |
reason | string | Yes | Why the renewal proposal is being declined. Recorded on the audit event. |
Request contract suite signatures
Changes dataatlas_contracts_suite_signatures_request
Send an approved contract to its signers via the eSign workflow. Returns the contract with status: OUT_FOR_SIGNATURE.
- Scope
contracts:write- Calls
- Example prompt
- Send ctr_xyz out for signature - approvals are all in.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
id | string | Yes | Contract id (e.g. ctr_...). |
Terminate contract suite
Destructiveatlas_contracts_suite_terminate
Terminate an executed contract. Records the reason on the audit event. Returns the contract with status: TERMINATED.
- Scope
contracts:write- Calls
- Example prompt
- Terminate ctr_xyz - breach of payment terms.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
id | string | Yes | Contract id (e.g. ctr_...). |
reason | string | Yes | Why the contract is being terminated. Recorded on the audit event. |
Terminate contracts
Destructiveatlas_contracts_terminate
Terminate an active contract (with a required reason recorded on the audit log).
- Scope
contracts:write- Calls
- Example prompt
- Terminate contract con_xyz: customer churned.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
id | string | Yes | |
reason | string | Yes |
Transition contracts
Changes dataatlas_contracts_transition
Move a contract to its next status: submit it for internal review, approve it, request changes, decline it, submit it to the counterparty, send it for signature, or terminate it. Returns the contract with its new status.
- Scope
contracts:write- Calls
- Example prompt
- Send contract ctr_123 for signature now that the internal review approved it.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
id | string | Yes | Contract id. |
transition | "submit-internal" | "approve" | "request-changes" | "decline" | "submit-external" | "send-for-signature" | "terminate" | Yes | The step to take: submit-internal, approve, request-changes, decline, submit-external, send-for-signature, or terminate. The API answers 409 when the step is not open from the current status. |
comment | string | No | Why. Required to request changes, to decline, and to terminate (recorded as the reason). Optional when approving. |
Update contracts
Changes dataatlas_contracts_update
Patch fields on an existing contract (any subset of the create payload).
- Scope
contracts:write- Calls
- Example prompt
- Update contract con_xyz to add a new counterparty.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
id | string | Yes | |
patch | object | Yes | Fields to update. |
Compare contract versions
Read onlyatlas_contracts_versions_compare
Compute the redline diff between two contract versions (from -> to).
- Scope
contracts:read- Calls
- Example prompt
- Show me the redline between v1 and v3 of contract con_xyz.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
id | string | Yes | |
from | integer | Yes | Earlier version number. |
to | integer | Yes | Later version number. |
Create contract versions
Changes dataatlas_contracts_versions_create
Record a new contract version by file SHA-256 (call after storing the file in object storage).
- Scope
contracts:write- Calls
- Example prompt
- Upload v3 of contract con_xyz.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
id | string | Yes | Contract id the new version belongs to. |
fileSha256 | string | Yes | SHA-256 hex digest of the uploaded file. |
comment | string | No |
List contract versions
Read onlyatlas_contracts_versions_list
List the versions of a contract in upload order (oldest first), one page at a time. Returns a nextCursor; pass it back as cursor for the next page.
- Scope
contracts:read- Calls
- Example prompt
- List versions of contract con_xyz.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
id | string | Yes | |
limit | integer | No | How many rows to return, 1 to 100. 50 by default. |
cursor | string | No | The nextCursor of the previous page. Leave it out for the first page. |
sort | "versionNumber" | "uploadedAt" | No | The field to sort on: versionNumber, uploadedAt. versionNumber by default. |
order | "asc" | "desc" | No | asc or desc. asc by default. |