Endpoint
GET /tasks/{task_id}/latest-negotiation-versions
Authentication
This endpoint requires authentication via API key. Include your API key in the X-API-Key header:
X-API-Key: ca_your_api_key_here
Path Parameters
| Parameter | Type | Required | Description |
|---|
task_id | integer | Yes | Unique identifier for the task |
Query Parameters
| Parameter | Type | Required | Description |
|---|
step_run_id | string | Yes | ID of the negotiation step run to retrieve versions for |
Request Example
curl -X GET "https://platform.chamelio.ai/tasks/12345/latest-negotiation-versions?step_run_id=sr_abc123" \
-H "X-API-Key: ca_your_api_key_here"
import requests
task_id = 12345
url = f"https://platform.chamelio.ai/tasks/{task_id}/latest-negotiation-versions"
headers = {
"X-API-Key": "ca_your_api_key_here"
}
params = {
"step_run_id": "sr_abc123"
}
response = requests.get(url, headers=headers, params=params)
print(response.json())
const taskId = 12345;
const response = await fetch(
`https://platform.chamelio.ai/tasks/${taskId}/latest-negotiation-versions?step_run_id=sr_abc123`,
{
method: 'GET',
headers: {
'X-API-Key': 'ca_your_api_key_here'
}
}
);
const data = await response.json();
console.log(data);
Response
Success Response
Status Code: 200 OK
{
"files": [
{
"file_uuid": "5f1c2d8a-3b4e-4f6a-9c10-2e7b8d9a1f23",
"file_id": "document_789",
"file_name": "vendor_agreement.docx",
"version": 3,
"uploading_party": "counterparty",
"our_party_changes": false,
"download_url": "https://s3.amazonaws.com/chamelio-files/...",
"expires_at": "2025-01-20T12:00:00Z"
}
]
}
Response Fields
| Field | Type | Description |
|---|
files | array | Latest version of each negotiation file on the step |
Negotiation File Object Fields
| Field | Type | Description |
|---|
file_uuid | string | Negotiation thread UUID. Pass this as file_uuid when uploading the next version of the same document |
file_id | string | SOR file reference (document_{id} or attachment_{id}) used for download |
file_name | string | Name of the negotiation document |
version | integer | Version number of this negotiation document |
uploading_party | string | Party that uploaded this version: legal (our side), counterparty, or stakeholders (internal) |
our_party_changes | boolean | Whether this version contains changes made by your party (true when the uploading party is not the counterparty) |
download_url | string | Presigned URL to download the document |
expires_at | string | ISO 8601 timestamp when the download URL expires |
Error Responses
401 Unauthorized
Returned when authentication fails. See the authentication errors section for details.
{
"detail": "Invalid API key"
}
404 Not Found
Returned when the task doesn’t exist, you don’t have access to it, or no negotiation version is available.
{
"detail": "Task not found"
}
422 Validation Error
Returned when the request parameters are invalid (e.g., step_run_id is missing).
{
"detail": [
{
"loc": ["query", "step_run_id"],
"msg": "field required",
"type": "value_error.missing"
}
]
}
500 Internal Server Error
Returned when the request fails due to a server error.
{
"detail": "Failed to get latest negotiation versions"
}
Notes
A negotiation step can carry more than one document. This endpoint returns the most recent version of each negotiation file on the step, keyed by its file_uuid thread.
Use file_uuid to track a document across negotiation rounds. When you upload the next version with Upload Negotiation Version, pass the same file_uuid to add to the existing thread. The presigned download URLs expire after a certain time (indicated by expires_at). Download the files before the URLs expire or request them again.
Use Cases
This endpoint is useful for:
- Negotiation tracking - Monitor the current state of every document under negotiation on a step
- Document retrieval - Download the latest version of each negotiated document
- Turn detection - Use
uploading_party and our_party_changes to determine which side made the most recent changes
- Integration - Sync negotiation progress with external contract management systems
