Contract Update

Edit the data of a contract while it is still in the created status. After submission, the contract can no longer be changed.

info

Only contracts with the created status can be updated.

Request

ENDPOINT

/expense_submission/fund_class/{fund_class_key}/contract/{contract_key}

METHOD

PUT

Path params

Parameter	Type	Description
fund_class_key	string	Unique key of the fund (UUID)
contract_key	string	Unique key of the contract

Request Body

{
    "name": "Contrato de Auditoria - Exercício 2026 (revisado)",
    "vendor_key": "3571e292-3a83-4011-904d-20ee963022ef",
    "expense_type": "audit_tax",
    "submission_nature": "manual_submission",
    "contract_value": 60000.00,
    "validity_date": "2026-12-31"
}

Body attributes

Field	Type	Required	Description
name	string	optional	New contract name. Maximum of 255 characters.
vendor_key	string	optional	New vendor key.
expense_type	string	optional	New expense type. See Expense types.
submission_nature	string	optional	New submission nature: manual_submission or rebate.
contract_value	number	optional	New maximum contract value. Minimum: 0.
validity_date	string	optional	New validity date in the YYYY-MM-DD format.

Response

STATUS

200

Response Body

{
    "name": "Contrato de Auditoria - Exercício 2026 (revisado)",
    "contract_key": "contrato-auditoria-2026",
    "fund_class": {
        "name": "FUNDO DE INVESTIMENTO EM DIREITOS CREDITÓRIOS EXEMPLO",
        "manager": {
            "name": "EXEMPLO GESTORA LTDA",
            "manager_key": "a7498c6c-1893-42ec-a8f3-bc6ad0c6b52c",
            "document_number": "45.585.471/0001-47"
        },
        "fund_class_key": "4b8377d0-58ec-479f-8ee9-9f963d5c47ad",
        "document_number": "60.910.091/0001-24"
    },
    "vendor": {
        "vendor_key": "3571e292-3a83-4011-904d-20ee963022ef",
        "name": "AUDITORES EXEMPLO S.A.",
        "document_number": "12.345.678/0001-90",
        "requires_invoice": "True"
    },
    "expense_type": "audit_tax",
    "status": "created",
    "contract_value": 60000.00,
    "validity_date": "2026-12-31",
    "submission_nature": "manual_submission"
}

The response attributes follow the same structure as the contract creation.

Possible errors

STATUS

404

Contract not found

The fund_class_key + contract_key pair does not correspond to any registered contract.

{
  "title": "Contract Not Found",
  "description": "Contract with key {contract_key} and fund class {fund_class_key} was not found.",
  "translation": "O contrato com chave {contract_key} do fundo {fund_class_key} não foi encontrado.",
  "code": "ESB000011"
}

STATUS

400

Contract cannot be edited in this status

The contract is not in the created status and cannot be edited.

{
  "title": "Cannot Update Contract In This Status",
  "description": "Contract {contract_key} cannot be updated with status {current_status}.",
  "translation": "O contrato {contract_key} não pode ser atualizado com o status {current_status}.",
  "code": "ESB000022"
}

Next steps

1. Submit the contract — send the contract for analysis when it is ready.
2. Cancel the contract — cancel the contract if it is no longer needed.