Skip to content
Recruso API

Update a subcontractor key information document

PUT
/v1/key-information-for-subcontractor-workers
curl --request PUT \
  --url https://api2.recruso.co.uk/v1/key-information-for-subcontractor-workers \
  --header 'Authorization: <Authorization>' \
  --header 'Content-Type: application/json' \
  --data '{ "contractType": "example", "businessConnectionWithSubContractor": "example", "expectedGrossPayRate": "example", "deductionFromSubContractorIncome": "example", "otherDeductionFromSubContractorIncome": "example", "expectedPayRate": "example", "deductionFromWage": "example", "extraDeductionFromWage": "example", "feesForServices": "example", "holidayEntitlementAndPay": "example", "additionalBenefits": "example", "exampleGrossPayRateToSubContractor": "example", "deductionFromSubContractor": "example", "extraDeductionFromSubContractorIncome": "example", "examplePayRate": "example", "deductionFromWorkersPay": "example", "extraDeductionFromWorkersPay": "example", "extraFeesForServices": "example", "netTakeHomePay": "example", "exampleGrossPayRateToWorker": "example", "deductionFromWorker": "example", "extraDeductionFromWorkerIncome": "example", "examplePayRateSubContractor": "example", "deductionFromSubContractorPay": "example", "extraDeductionFromSubContractorPay": "example", "extraFeesForServicesForSubContractor": "example", "netTakeHomePaySubContractor": "example" }'

Updates one of your agency’s subcontractor key information documents. Nothing calculates from these values — they are reproduced as text in reports, which is the whole of what the document is for.

Send the complete record: the fields you supply replace the stored values.

Names are not checked for uniqueness.

You only ever see and change your own agency’s records; there is no owner id on the request, and an id belonging to another agency returns 404 rather than 403 so that its existence is never disclosed.

Access. Requires a client-credentials access token. Tokens issued through the interactive user login are rejected.

Authorizations

Section titled “Authorizations”

Request Bodyrequired

Section titled “Request Bodyrequired”
Media typeapplication/json
object
contractType
string
nullable
businessConnectionWithSubContractor
string
nullable
expectedGrossPayRate
string
nullable
deductionFromSubContractorIncome
string
nullable
otherDeductionFromSubContractorIncome
string
nullable
expectedPayRate
string
nullable
deductionFromWage
string
nullable
extraDeductionFromWage
string
nullable
feesForServices
string
nullable
holidayEntitlementAndPay
string
nullable
additionalBenefits
string
nullable
exampleGrossPayRateToSubContractor
string
nullable
deductionFromSubContractor
string
nullable
extraDeductionFromSubContractorIncome
string
nullable
examplePayRate
string
nullable
deductionFromWorkersPay
string
nullable
extraDeductionFromWorkersPay
string
nullable
extraFeesForServices
string
nullable
netTakeHomePay
string
nullable
exampleGrossPayRateToWorker
string
nullable
deductionFromWorker
string
nullable
extraDeductionFromWorkerIncome
string
nullable
examplePayRateSubContractor
string
nullable
deductionFromSubContractorPay
string
nullable
extraDeductionFromSubContractorPay
string
nullable
extraFeesForServicesForSubContractor
string
nullable
netTakeHomePaySubContractor
string
nullable
Examplegenerated
{
  "contractType": "example",
  "businessConnectionWithSubContractor": "example",
  "expectedGrossPayRate": "example",
  "deductionFromSubContractorIncome": "example",
  "otherDeductionFromSubContractorIncome": "example",
  "expectedPayRate": "example",
  "deductionFromWage": "example",
  "extraDeductionFromWage": "example",
  "feesForServices": "example",
  "holidayEntitlementAndPay": "example",
  "additionalBenefits": "example",
  "exampleGrossPayRateToSubContractor": "example",
  "deductionFromSubContractor": "example",
  "extraDeductionFromSubContractorIncome": "example",
  "examplePayRate": "example",
  "deductionFromWorkersPay": "example",
  "extraDeductionFromWorkersPay": "example",
  "extraFeesForServices": "example",
  "netTakeHomePay": "example",
  "exampleGrossPayRateToWorker": "example",
  "deductionFromWorker": "example",
  "extraDeductionFromWorkerIncome": "example",
  "examplePayRateSubContractor": "example",
  "deductionFromSubContractorPay": "example",
  "extraDeductionFromSubContractorPay": "example",
  "extraFeesForServicesForSubContractor": "example",
  "netTakeHomePaySubContractor": "example"
}

Responses

Section titled “Responses”

200

Section titled “200”

OK

Media typeapplication/json
object
contractType
string
nullable
businessConnectionWithSubContractor
string
nullable
expectedGrossPayRate
string
nullable
deductionFromSubContractorIncome
string
nullable
otherDeductionFromSubContractorIncome
string
nullable
expectedPayRate
string
nullable
deductionFromWage
string
nullable
extraDeductionFromWage
string
nullable
feesForServices
string
nullable
holidayEntitlementAndPay
string
nullable
additionalBenefits
string
nullable
exampleGrossPayRateToSubContractor
string
nullable
deductionFromSubContractor
string
nullable
extraDeductionFromSubContractorIncome
string
nullable
examplePayRate
string
nullable
deductionFromWorkersPay
string
nullable
extraDeductionFromWorkersPay
string
nullable
extraFeesForServices
string
nullable
netTakeHomePay
string
nullable
exampleGrossPayRateToWorker
string
nullable
deductionFromWorker
string
nullable
extraDeductionFromWorkerIncome
string
nullable
examplePayRateSubContractor
string
nullable
deductionFromSubContractorPay
string
nullable
extraDeductionFromSubContractorPay
string
nullable
extraFeesForServicesForSubContractor
string
nullable
netTakeHomePaySubContractor
string
nullable
Examplegenerated
{
  "contractType": "example",
  "businessConnectionWithSubContractor": "example",
  "expectedGrossPayRate": "example",
  "deductionFromSubContractorIncome": "example",
  "otherDeductionFromSubContractorIncome": "example",
  "expectedPayRate": "example",
  "deductionFromWage": "example",
  "extraDeductionFromWage": "example",
  "feesForServices": "example",
  "holidayEntitlementAndPay": "example",
  "additionalBenefits": "example",
  "exampleGrossPayRateToSubContractor": "example",
  "deductionFromSubContractor": "example",
  "extraDeductionFromSubContractorIncome": "example",
  "examplePayRate": "example",
  "deductionFromWorkersPay": "example",
  "extraDeductionFromWorkersPay": "example",
  "extraFeesForServices": "example",
  "netTakeHomePay": "example",
  "exampleGrossPayRateToWorker": "example",
  "deductionFromWorker": "example",
  "extraDeductionFromWorkerIncome": "example",
  "examplePayRateSubContractor": "example",
  "deductionFromSubContractorPay": "example",
  "extraDeductionFromSubContractorPay": "example",
  "extraFeesForServicesForSubContractor": "example",
  "netTakeHomePaySubContractor": "example"
}

400

Section titled “400”

Bad Request

Media typeapplication/problem+json
object
type
string
nullable
title
string
nullable
status
integer format: int32
nullable
detail
string
nullable
instance
string
nullable
Examplegenerated
{
  "type": "example",
  "title": "example",
  "status": 1,
  "detail": "example",
  "instance": "example"
}

401

Section titled “401”

Unauthorized

Media typeapplication/problem+json
object
type
string
nullable
title
string
nullable
status
integer format: int32
nullable
detail
string
nullable
instance
string
nullable
Examplegenerated
{
  "type": "example",
  "title": "example",
  "status": 1,
  "detail": "example",
  "instance": "example"
}

403

Section titled “403”

Forbidden

Media typeapplication/problem+json
object
type
string
nullable
title
string
nullable
status
integer format: int32
nullable
detail
string
nullable
instance
string
nullable
Examplegenerated
{
  "type": "example",
  "title": "example",
  "status": 1,
  "detail": "example",
  "instance": "example"
}

404

Section titled “404”

Not Found

Media typeapplication/problem+json
object
type
string
nullable
title
string
nullable
status
integer format: int32
nullable
detail
string
nullable
instance
string
nullable
Examplegenerated
{
  "type": "example",
  "title": "example",
  "status": 1,
  "detail": "example",
  "instance": "example"
}