Skip to main content
PUT
/
v1
/
contracts
/
{id}
Update contract
curl --request PUT \
  --url https://api.useaira.com/v1/contracts/{id} \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '{
  "paymentAccount": {
    "businessName": "<string>",
    "tradeName": "<string>",
    "taxId": "<string>",
    "taxIdType": "cnpj",
    "email": "jsmith@example.com",
    "address": {
      "zipCode": "<string>",
      "number": "<string>",
      "street": "<string>",
      "neighborhood": "<string>",
      "city": "<string>",
      "state": "AC",
      "country": "Brasil",
      "complement": "<string>"
    }
  },
  "paymentAccountId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "contract": {
    "startDate": "2023-12-25",
    "endDate": "2023-12-25",
    "billingEndDay": 16,
    "rateAdjustmentIndex": "none",
    "planIds": [
      "<string>"
    ],
    "paymentSettings": {
      "scheduledPaymentDay": 16,
      "dueOffsetDays": 6
    },
    "billingSettings": {
      "billingCycleMinimumAmount": 1
    },
    "customFields": {
      "customField1": "value1",
      "customField2": [
        "value2",
        "value3"
      ]
    }
  }
}'
{
  "contract": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "startDate": "2023-12-25",
    "endDate": "2023-12-25",
    "billingEndDay": 16,
    "status": "active",
    "sendNotifications": true,
    "rateAdjustmentIndex": "none",
    "plans": [
      {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "name": "<string>",
        "description": "<string>"
      }
    ],
    "paymentSettings": {
      "scheduledPaymentDay": 16,
      "dueOffsetDays": 6
    },
    "billingSettings": {
      "billingCycleMinimumAmount": 1
    },
    "customFields": {
      "customField1": "value1",
      "customField2": [
        "value2",
        "value3"
      ]
    }
  },
  "customer": {
    "id": "<string>",
    "externalId": "705faf65-9c8b-4053-8c0b-2021281ce83f",
    "name": "Acme Inc.",
    "customFields": {
      "customField1": "value1",
      "customField2": [
        "value2",
        "value3"
      ]
    }
  },
  "paymentAccount": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "businessName": "<string>",
    "tradeName": "<string>",
    "taxId": "<string>",
    "taxIdType": "cnpj",
    "email": "jsmith@example.com",
    "address": {
      "zipCode": "<string>",
      "number": "<string>",
      "street": "<string>",
      "neighborhood": "<string>",
      "city": "<string>",
      "state": "AC",
      "country": "Brasil",
      "complement": "<string>"
    }
  }
}

Authorizations

​
X-API-KEY
string
header
required

API Key Authentication.

Path Parameters

​
id
string<uuid>
required

The contract id.

Body

application/json

A contract object.

  • New contract with a new payment account.
  • New contract with an existing payment account.

A contract object. Provide a new payment account to create a new contract for the new payment account.

​
paymentAccount
object
required

New Payment Account details.

​
contract
object
required

New Contract details.

​
paymentAccountId
string<uuid>

Existing payment account ID. If provided, a new payment account will not be created. Note: You cannot provide both a paymentAccountId and a new paymentAccount object at the same time.

Response

The request was successfully processed, and the contract has been updated. The response contains the details of the updated contract.

​
contract
object
required

Schema defining the contract details.

​
customer
object
required

Schema representing a customer.

​
paymentAccount
object
required

Schema representing a payment account.