canonical: https://jentic.com/apis/clment.com/clment

# Clment REST API

The Clment REST API gives programmatic access to a contract workspace: it lists, uploads, and reads contracts, tracks their document versions and activity, and manages the tags and lifecycle status across many contracts at once. It starts AI reviews against rulebooks, returns findings with decisions and comments, generates redlines, and can answer a question across your contracts or search them by full text. Key dates carry reminders, chat sessions hold saved conversations, and the API converts a PDF to Word. Keys are issued per region, with hosts for the US, EU, UK, CA, AU, and NZ.

## For AI agents

List, upload, and read contracts, run AI reviews against rulebooks, generate redlines, and search or ask questions across a contract workspace. Authenticated with a region-specific bearer key.

## Scope

Does not provide e-signature, billing, or CRM. Use for contract storage, AI review, search, and key-date tracking only.

## Capabilities

- Upload a contract from a file or URL and read its extracted text and versions
- Start an AI review against a rulebook and act on its findings
- Generate a redline and download it by token
- Ask a question across your contracts or run a full-text search
- Track key dates and set reminders on them
- Bulk-tag, bulk-set-status, or bulk-delete many contracts at once
- Convert a PDF to Word from a file or URL

## Use cases

### Agent-Run Contract Review

An AI agent uploads a contract, starts a review against a rulebook, and reads the findings through Jentic, then generates a redline when changes are needed. The region-specific bearer key scopes access to one workspace, and a rule can keep the agent on uploading and reviewing while deletes and bulk operations stay out. The agent finds each operation by intent and calls it directly.

Example prompt: Upload a vendor contract, start a review against the standard rulebook, and list the findings it returns.

### Contract Search and Q&A

A workflow searches a contract portfolio and asks natural-language questions across it, pulling the extracted text and activity for each matching contract. Clment returns results scoped to the workspace key and keeps document versions so answers cite the right revision. Teams use this to answer obligation and renewal questions without opening every file.

Example prompt: Search contracts for 'auto-renewal' and ask what notice period each requires, citing the version.

### Key-Date and Obligation Tracking

A workflow lists the key dates across a contract portfolio, adds custom dates to a contract, and sets reminders so a renewal or deadline is not missed. Clment stores dates per contract and surfaces portfolio KPIs in a dashboard summary. Teams use this to stay ahead of obligations across many agreements.

Example prompt: List the key dates due in the next 30 days and set a reminder on each renewal.

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| GET | `/contracts` | List contracts |
| POST | `/contracts/upload` | Upload a contract file |
| GET | `/contracts/{id}` | Get a contract |
| POST | `/contracts/{id}/review` | Start an AI review |
| GET | `/reviews` | List reviews |
| POST | `/ask` | Ask a question across your contracts |
| GET | `/search` | Search contracts |
| GET | `/dates` | List key dates |

## Key resources

- **Contracts** — List, upload, read, update, and delete contracts, with tags, versions, activity, and bulk operations
- **Reviews** — Start AI reviews against rulebooks, act on findings, add comments, and complete a review
- **Rulebooks** — Create, list, read, and delete the rulebooks reviews run against
- **Key dates** — List key dates, add custom dates to a contract, and set reminders
- **Search and ask** — Search contracts and ask questions across them, with chat sessions for saved conversations
- **Conversion** — Convert a PDF to Word from a file or URL

## AI readiness

This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use.

- **Score:** 68 / 100
- **Maturity:** AI-Aware
- **Dimensions:**
  - Foundational Compliance: 99 / 100
  - Developer Experience & Jentic Compatibility: 63 / 100
  - AI-Readiness & Agent Experience: 50 / 100
  - Agent Usability: 93 / 100
  - Security: 60 / 100
  - AI Discoverability: 77 / 100
- **View full report:** https://jentic.com/apis/clment.com/clment/scorecard
- **How the score is calculated:** https://docs.jentic.com/reference/api-readiness-framework/overview/
- **More about the dimensions:** https://docs.jentic.com/reference/api-readiness-framework/specification/#dimensional-model-overview

### Score it yourself

Every API in the directory is allowlisted, so you can re-score it with no key required.

- **Score your own API:** https://jentic.com/scorecard.md
- **Scoring CLI agent skill:** https://github.com/jentic/jentic-api-scorecard/blob/main/skills/jentic-api-scorecard/SKILL.md

```sh
npx @jentic/api-scorecard-cli score <openapi-url>
```

## Why Jentic

- **Setup:** Wiring the Clment API by hand means generating a clm_sk_live_ key, sending it as a bearer token, and picking the right regional host among the US, EU, UK, CA, AU, and NZ endpoints. Through Jentic you install once, import Clment from the API Directory, store the key once, and your agent calls it.
- **Permission scoping:** Clment carries the contract id and review id in the URL path, so a rule can pin your agent to reading, searching, and reviewing specific contracts. You choose the operations it may call, so destructive ones like deleting a contract or a bulk-delete are not included unless you add them.
- **Credential handling:** Your Clment key is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'start a contract review' or 'search our contracts', and Jentic returns the matching Clment operation with its input schema so the agent calls the right endpoint without reading the reference docs.

## Related APIs

- **PandaDoc** — Document and contract automation with templates and e-signature.
- **Box** — Cloud content storage with versioning and sharing for documents.
- **CloudConvert** — File conversion across many document and media formats.

## FAQ

### What authentication does the Clment API use?

The Clment API authenticates with a bearer token in the Authorization header, per its OpenAPI spec, using keys that start with clm_sk_live_. You generate a key in the app under Settings, and it is scoped to one workspace. Keys are region-specific, with separate hosts for the US, EU, UK, CA, AU, and NZ. Through Jentic the key is stored encrypted by your own Jentic One instance and injected only at call time.

### Can I run AI contract reviews with the Clment API?

Yes. You upload a contract, start a review against a rulebook, and read its findings, then apply decisions, add comments, and generate a redline. You can also ask questions across your contracts and search them by full text.

### What are the rate limits for the Clment API?

The OpenAPI spec does not specify rate limits for the Clment API; the credits and limits for the current period are reported by the usage endpoint. Check the vendor's documentation at https://clment.com/help/api for current limits.

### Can I limit what my agent is allowed to do with the Clment API?

Yes. Write a rule that allows the read, search, and review operations but not deletes or bulk changes, so the agent can analyze contracts without removing any. Contract and review ids travel in the URL path, so the rule binds cleanly, and every call it makes is logged.

### Is there a Clment MCP server?

You don't need an MCP server to give your agent the Clment API. Jentic connects it directly from the API Directory: import it, store your region-specific key once, and your agent calls the contract, review, and search operations. You skip loading another server's tool definitions into the agent's context.

### How do I run a contract review through Jentic?

Add the Clment API from the Jentic API Directory and store your region-specific key once. Your agent then searches by intent such as 'start a contract review' and Jentic returns the matching operation with its input schema, so it can upload the contract and read the findings. To run it on your own infrastructure, install Jentic One from its GitHub repo.