Update a contract's custom fields | YunoJuno API Documentation

curl -X POST https://api.yunojuno.com/contracts/contract_id/custom_fields/ \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "custom_fields": [
    {
      "name": "string",
      "value": "string"
    }
  ]
}'

{
  "data": {
    "contract_id": "string",
    "freelancer": {
      "freelancer_id": "string",
      "first_name": "string",
      "last_name": "string",
      "full_name": "string",
      "email": "string",
      "date_of_birth": "2023-01-15",
      "legal_name": "string"
    },
    "freelancer_operating_jurisdiction": {
      "name": "string",
      "country_code": "string"
    },
    "freelancer_personal_tax_jurisdiction": {
      "name": "string",
      "country_code": "string"
    },
    "client": {
      "client_id": "string",
      "name": "string"
    },
    "client_contact": {
      "client_contact_id": "string",
      "freelancer_id": "string",
      "custom_fields": [
        {
          "name": "string",
          "value": "string",
          "metadata": null
        }
      ],
      "url": "string"
    },
    "hirers": [
      {
        "hirer_id": "string",
        "first_name": "string",
        "last_name": "string",
        "full_name": "string",
        "email": "string"
      }
    ],
    "title": "string",
    "job_title": "string",
    "description": "string",
    "start_date": "2023-01-15",
    "end_date": "2023-01-15",
    "actual_end_date": "string",
    "rate": {
      "value": "string",
      "unit": "string",
      "currency": "AUD"
    },
    "work_time_type": "string",
    "fee_schedule": {
      "periods": [
        {
          "effective_from": "2023-01-15",
          "fees": [
            {
              "percentage": "string",
              "value": "string",
              "currency": "string",
              "name": "string"
            }
          ],
          "total_fees": {
            "currency": "string",
            "value": "string"
          },
          "total_cost": {
            "currency": "string",
            "value": "string"
          }
        }
      ]
    },
    "notice_period_days": 1,
    "work_location": "string",
    "minutes_in_working_day": 1,
    "custom_fields": [
      {
        "name": "string",
        "value": "string",
        "metadata": null
      }
    ],
    "pre_offer_approval_flow": {
      "approval_flow_id": "string",
      "current_approval_step": {
        "approval_step_id": "string"
      }
    },
    "spend_request": {
      "spend_request_id": "string",
      "url": "string",
      "external_id": "string",
      "title": "string",
      "description": "string",
      "amount": "string",
      "amount_type": "DAY_RATE",
      "currency": "AUD",
      "custom_fields": [
        {
          "name": "string",
          "value": "string",
          "metadata": null
        }
      ],
      "approval_flow": {
        "approval_flow_id": "string",
        "current_approval_step": {
          "approval_step_id": "string"
        }
      },
      "attachment_url": "string"
    },
    "renewal_meta": {
      "is_initial_contract": true,
      "is_renewal": true,
      "has_subsequent_renewal": true,
      "initial_contract_id": "string",
      "parent_contract_id": "string",
      "renewal_chain_position": 1,
      "renewal_chain": [
        "string"
      ]
    },
    "historical_meta": {
      "has_previously_accepted_contract": true
    },
    "url": "string"
  }
}

Update the custom fields for a contract.

Custom fields are client-defined metadata configured on your YunoJuno account (for example cost centres, project codes or internal tags). Only the fields supplied are validated and updated; required fields not included in the request are left unchanged.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

contract_idstringRequiredformat: "^ct_c[a-z0-9]{24}$"

Request

This endpoint expects an object.

custom_fieldslist of objectsRequired

An array of custom fields to update for the contract.

Response

This endpoint returns an object.

dataobject

The contract object. This objects represents a contract on the YunoJuno platform between a client and a freelancer.

Errors

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error

422

Unprocessable Entity Error