Update CoworkerContract

PUT

api

billing

coworkercontracts

curl --request PUT \
  --url https://spaces.nexudus.com/api/billing/coworkercontracts \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "Id": 123,
  "IssuedById": 123,
  "CoworkerId": 123,
  "TariffId": 123,
  "BillingDay": 123,
  "Quantity": 123
}
'

import requests

url = "https://spaces.nexudus.com/api/billing/coworkercontracts"

payload = {
    "Id": 123,
    "IssuedById": 123,
    "CoworkerId": 123,
    "TariffId": 123,
    "BillingDay": 123,
    "Quantity": 123
}
headers = {
    "Authorization": "Basic <encoded-value>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PUT',
  headers: {Authorization: 'Basic <encoded-value>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    Id: 123,
    IssuedById: 123,
    CoworkerId: 123,
    TariffId: 123,
    BillingDay: 123,
    Quantity: 123
  })
};

fetch('https://spaces.nexudus.com/api/billing/coworkercontracts', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "Status": 123,
  "Message": "<string>",
  "Value": "<any>",
  "WasSuccessful": true,
  "Errors": [
    {
      "AttemptedValue": "<any>",
      "Message": "<string>",
      "PropertyName": "<string>"
    }
  ]
}

Updates an existing CoworkerContract record. You must include the Id of the record to update along with all required fields.

Authentication

This endpoint requires OAuth2 authentication. Include a valid bearer token in the Authorization header. The authenticated user must be a full unrestricted administrator or have the CoworkerContract-Edit role.

Enums

eCancellationReason

Value	Name
1	PriceTooHigh
2	NewJobRelocation
3	MovedToOtherSpace
4	ChangeWorkEnvironment
5	LackCommunityInterations
6	PoorSpaceCondition
7	OtherMembers
8	Rellocated
9	BusinessExpansion
10	Pause
11	Renewed
12	Upgraded
13	Downgraded
19	Covid19
99	Other

eDeliveryHandlingPreference

Value	Name
1	StoreForCollection
2	Forward
3	OpenScanForward
4	OpenScanRecycle
5	OpenScanShred
6	OpenScanStoreForCollection
7	Recycle
8	ReturnToSender
9	Shred
10	DepositCheck
11	Unknown

Request Body

Required Fields

integer

required

The Id of the CoworkerContract record to update.

integer

required

ID of the issued by linked to this record.

integer

required

ID of the coworker linked to this record.

integer

required

ID of the tariff linked to this record.

integer

required

Day of month on which billing occurs.

integer

required

Number of units.

Optional Fields

integer

ID of the next tariff linked to this record.

string

Free-text notes for this contract.

string

Contract start date.

string

Date on which the contract will next be automatically invoiced. Updated automatically every time the contract is invoiced, advancing by the plan’s renewal period.

string

Period the next invoice will cover. For new contracts this equals RenewalDate. If Tariff.AdvanceInvoiceCycles > 1, Nexudus invoices several periods at once on the first invoice, pushing InvoicedPeriod ahead of RenewalDate. Nexudus stops invoicing when InvoicedPeriod reaches the cancellation date.

string

Minimum contract length end date. Defines the earliest date at which the contract can be cancelled without penalty.

number

Fixed price override for this contract. If null, the contract uses the plan’s default price (TariffPrice).

number

Contract value used in reporting to compare against the actual invoiced price.

integer[]

List of desks linked to this record.

integer[]

The added desks value for this coworker contract.

integer[]

The removed desks value for this coworker contract.

integer[]

List of variants linked to this record.

integer[]

The added variants value for this coworker contract.

integer[]

The removed variants value for this coworker contract.

string

Purchase order.

Whether to include the plan’s signup fee when creating this contract.

boolean

Whether to invoice multiple billing cycles in advance on the first invoice, as configured by Tariff.AdvanceInvoiceCycles.

boolean

Whether to pro-rate the first invoice based on the contract start date relative to the billing cycle.

string

Date of the next automatic invoice generation for this contract.

boolean

Whether the customer has accepted the plan’s terms and conditions.

string

Date on which the contract will be cancelled. Nexudus stops invoicing when InvoicedPeriod reaches this date.

integer

Minimum number of days’ notice required before cancellation takes effect.

boolean

Whether to pro-rate the final invoice when the contract is cancelled mid-cycle.

boolean

Whether to cascade cancellation to contracts of team members under this customer.

integer

Reason for cancellation. See eCancellationReason? enum above.

string

Free-text notes about the cancellation.

integer

Delivery handling preference for checks. See eDeliveryHandlingPreference? enum above.

integer

Delivery handling preference for mail. See eDeliveryHandlingPreference? enum above.

integer

Delivery handling preference for parcels. See eDeliveryHandlingPreference? enum above.

integer

Delivery handling preference for publicity. See eDeliveryHandlingPreference? enum above.

string

Free-text delivery instructions for this contract’s mail handling.

string

Date by which identity verification checks must be completed for this contract.

string

Date by which address verification checks must be completed for this contract.

string

Date/time value for start date local.

string

Date/time value for renewal date local.

string

Date/time value for next auto invoice local.

string

Date/time value for price plan terms accepted on local.

string

Date/time value for cancellation date local.

string

Date/time value for contract term local.

string

Date/time value for invoiced period local.

string

PO box number.

Children

object[]

Scheduled future price changes for this contract. Each entry sets a new Price to apply on a given date

Show child attributes

number

The new contract price to apply on the scheduled date.

string

required

Date on which the system will automatically update the contract price to the value in Price.

Code Examples

curl -X PUT \
  "https://spaces.nexudus.com/api/billing/coworkercontracts" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "IssuedById": 0,
    "CoworkerId": 0,
    "TariffId": 0,
    "BillingDay": 0,
    "Quantity": 0,
    "Id": 87654321,
    "ContractSchedules": [
        {
            "Price": null,
            "ApplyOn": "2025-01-15T10:30:00Z"
        }
    ]
}'

const response = await fetch(
  'https://spaces.nexudus.com/api/billing/coworkercontracts',
  {
    method: 'PUT',
    headers: {
      'Authorization': 'Bearer YOUR_TOKEN',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      IssuedById: 0,
      CoworkerId: 0,
      TariffId: 0,
      BillingDay: 0,
      Quantity: 0,
      Id: 87654321,
      ContractSchedules: [object Object]
    })
  }
);

const data = await response.json();

import requests

response = requests.put(
    'https://spaces.nexudus.com/api/billing/coworkercontracts',
    headers={
        'Authorization': 'Bearer YOUR_TOKEN',
        'Content-Type': 'application/json'
    },
    json={
        'IssuedById': 0,
        'CoworkerId': 0,
        'TariffId': 0,
        'BillingDay': 0,
        'Quantity': 0,
        'Id': 87654321,
        'ContractSchedules': [object Object]
    }
)

data = response.json()

Response

200

integer

HTTP status code. 200 on success.

string

A human-readable message confirming the update.

object

Contains the Id of the updated record.

boolean

true if the coworkercontract was updated successfully.

array

null on success.

Example Response

{
  "Status": 200,
  "Message": "CoworkerContract was successfully updated.",
  "Value": {
    "Id": 87654321
  },
  "OpenInDialog": false,
  "OpenInWindow": false,
  "RedirectURL": null,
  "JavaScript": null,
  "UpdatedOn": "2025-01-15T10:30:00Z",
  "UpdatedBy": "admin@example.com",
  "Errors": null,
  "WasSuccessful": true
}

400

string

A summary of the validation error(s), in the format PropertyName: error message.

any

null on validation failure.

object[]

Array of validation errors.

Show child attributes

any

The value that was submitted for the field, or null if missing.

string

The validation error message.

string

The name of the property that failed validation.

boolean

false when the request fails validation.

Example Response

{
  "Message": "PriceWithProductsAndDeposits: is a required field",
  "Value": null,
  "Errors": [
    {
      "AttemptedValue": null,
      "Message": "is a required field",
      "PropertyName": "PriceWithProductsAndDeposits"
    }
  ],
  "WasSuccessful": false
}

Delete CoworkerContractDelete an existing CoworkerContract record by its Id.

Update CoworkerContract

curl --request PUT \
  --url https://spaces.nexudus.com/api/billing/coworkercontracts \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "Id": 123,
  "IssuedById": 123,
  "CoworkerId": 123,
  "TariffId": 123,
  "BillingDay": 123,
  "Quantity": 123
}
'

import requests

url = "https://spaces.nexudus.com/api/billing/coworkercontracts"

payload = {
    "Id": 123,
    "IssuedById": 123,
    "CoworkerId": 123,
    "TariffId": 123,
    "BillingDay": 123,
    "Quantity": 123
}
headers = {
    "Authorization": "Basic <encoded-value>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PUT',
  headers: {Authorization: 'Basic <encoded-value>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    Id: 123,
    IssuedById: 123,
    CoworkerId: 123,
    TariffId: 123,
    BillingDay: 123,
    Quantity: 123
  })
};

fetch('https://spaces.nexudus.com/api/billing/coworkercontracts', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "Status": 123,
  "Message": "<string>",
  "Value": "<any>",
  "WasSuccessful": true,
  "Errors": [
    {
      "AttemptedValue": "<any>",
      "Message": "<string>",
      "PropertyName": "<string>"
    }
  ]
}

Overview

Apps & Marketplace

Billing

Collaboration

Community

Content

CRM

Security

Spaces

Support

System

Authentication

Enums

Request Body

Required Fields

Optional Fields

Children

Code Examples

Response

200

400

​Authentication

​Enums

​Request Body

​Required Fields

​Optional Fields

​Children

​Code Examples

​Response

​200

​400

Authentication

Enums

Request Body

Required Fields

Optional Fields

Children

Code Examples

Response

200

400