Update Entity

​

Update an existing entity with new data.

This endpoint supports both full and partial updates:

  • Partial Update: Provide only the fields you want to change. All other fields remain unchanged.
  • Full Update: Provide all fields to completely replace the entity data.

Args: entity_id: Unique identifier of the entity to update entity_info: Updated entity data including: - Fields to modify (partial update supported - only changed fields required) - All unchanged fields will retain their current values - Custom field updates if applicable user: Authenticated user information (used for audit trails) response: HTTP response object for status code modification

Returns: Complete updated entity data including: - All entity fields with updated values - Updated timestamp information - Computed fields and relationships

Note: - Returns HTTP 200 on successful update - Returns HTTP 206 (Partial Content) if entity is updated but some custom fields failed to update - Automatically updates modification timestamp and user information

Raises: HTTPException: - 400: Invalid input data or validation errors - 401: Authentication required - 403: Insufficient permissions to update this entity - 404: Entity not found - 409: Update conflict (entity modified by another user) - 422: Validation error in request data - 500: Internal server error during update

Path Parameters

  • entity_id
    Type: string
    required

Query Parameters

  • include_additionals
    Type: boolean

    Whether to include additional fields from the additional fields tab.

Body·

required
application/json
  • aeOwner
    Type: string
    max length:  
    50    nullable

    Account Executive owner ID

  • annualContractValue
    Type: numbernullable

    Annual contract value

  • annualContractValueLocal
    Type: numbernullable

    Annual contract value in local currency

  • arr
    Type: numbernullable

    Annual Recurring Revenue

  • arrLocal
    Type: numbernullable

    Annual Recurring Revenue in local currency

  • automaticallyAddedPartnerContacts
    Type: array of stringnullable

    Partner contacts automatically added to this contract

  • automaticallyAddedPeople
    Type: array of stringnullable

    People automatically added to this contract

  • carr
    Type: numbernullable

    Committed Annual Recurring Revenue

  • carrLocal
    Type: numbernullable

    Committed Annual Recurring Revenue in local currency

  • cmrr
    Type: numbernullable

    Committed Monthly Recurring Revenue

  • cmrrLocal
    Type: numbernullable

    Committed Monthly Recurring Revenue in local currency

  • companyId
    Type: string
    max length:  
    50    nullable

    Identifier of the associated company

  • propertyName
    additionalPropertyType: anything

Responses

  • application/json
  • application/json
Request Example for put/{entity_id}
curl 'https://crm.dreamhub.ai/api/v1/contracts/{entity_id}?include_additionals=false' \
  --request PUT \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '{
  "name": "",
  "dealId": "",
  "companyId": "",
  "productId": "",
  "status": 1,
  "arr": 1,
  "arrLocal": 1,
  "mrr": 1,
  "mrrLocal": 1,
  "currency": "",
  "revenueItems": [
    ""
  ],
  "annualContractValue": 1,
  "annualContractValueLocal": 1,
  "totalContractValue": 1,
  "totalContractValueLocal": 1,
  "startDate": "",
  "endDate": "",
  "duration": 1,
  "renewalType": 1,
  "nextRenewal": "",
  "nextOptOut": "",
  "signedOn": "",
  "csmOwner": "",
  "aeOwner": "",
  "carr": 1,
  "carrLocal": 1,
  "cmrr": 1,
  "cmrrLocal": 1,
  "financialOverride": true,
  "financialNote": "",
  "csmRenewalConfidenceLevel": 1,
  "isDetachedFromDeal": true,
  "manuallyAddedPeople": [
    ""
  ],
  "automaticallyAddedPeople": [
    ""
  ],
  "partnerId": "",
  "manuallyAddedPartnerContacts": [
    ""
  ],
  "automaticallyAddedPartnerContacts": [
    ""
  ],
  "onboardingStartDate": "",
  "onboardingCompletedAt": "",
  "uploadFiles": {
    "additionalProperty": "anything"
  },
  "additionalProperty": "anything"
}'

{
  "name": "string",
  "dealId": "string",
  "companyId": "string",
  "productId": "string",
  "status": 1,
  "arr": 1,
  "arrLocal": 1,
  "mrr": 1,
  "mrrLocal": 1,
  "currency": "string",
  "revenueItems": [],
  "annualContractValue": 1,
  "annualContractValueLocal": 1,
  "totalContractValue": 1,
  "totalContractValueLocal": 1,
  "startDate": "2026-10-07T22:43:40.394Z",
  "endDate": "2026-10-07T22:43:40.394Z",
  "duration": 1,
  "renewalType": 1,
  "nextRenewal": "2026-10-07T22:43:40.394Z",
  "nextOptOut": "2026-10-07T22:43:40.394Z",
  "signedOn": "2026-10-07T22:43:40.394Z",
  "csmOwner": "string",
  "aeOwner": "string",
  "carr": 1,
  "carrLocal": 1,
  "cmrr": 1,
  "cmrrLocal": 1,
  "financialOverride": true,
  "financialNote": "string",
  "csmRenewalConfidenceLevel": 1,
  "isDetachedFromDeal": true,
  "manuallyAddedPeople": [
    "string"
  ],
  "automaticallyAddedPeople": [
    "string"
  ],
  "partnerId": "string",
  "manuallyAddedPartnerContacts": [
    "string"
  ],
  "automaticallyAddedPartnerContacts": [
    "string"
  ],
  "onboardingStartDate": "2026-10-07T22:43:40.394Z",
  "onboardingCompletedAt": "2026-10-07T22:43:40.394Z",
  "uploadFiles": {
    "additionalProperty": "anything"
  },
  "id": "con-f47ac10b",
  "calculatedCarr": 1,
  "calculatedCarrLocal": 1,
  "calculatedCmrr": 1,
  "calculatedCmrrLocal": 1,
  "calculatedAnnualContractValue": 1,
  "calculatedAnnualContractValueLocal": 1,
  "calculatedTotalContractValue": 1,
  "calculatedTotalContractValueLocal": 1,
  "calculatedArr": 1,
  "calculatedArrLocal": 1,
  "calculatedMrr": 1,
  "calculatedMrrLocal": 1,
  "onboardingStageId": "string",
  "duplicatedFromContractId": "string",
  "snapshotOfDealId": "string",
  "createdAt": "2026-10-07T22:43:40.394Z",
  "serviceCount": 1,
  "period": "string",
  "csmRenewalConfidenceLevelLabel": "string",
  "onboardingStageName": "string",
  "onboardingStatus": "string",
  "percentageFromCsmRenewalBook": 1,
  "durationDisplay": "string",
  "additionalProperty": "anything"
}

Successful Response