Skip to content

Deel: Create a delivery request for an IT asset

Deel itAssets.deliverItAsset: arguments, response, policy and SDK examples.

← IT assets operations · Get started

Operation deel.itassets_deliveritasset_v2026_09_15

Provider route: POST /it/assets/{asset_id}/deliver. Alter supplies the connection’s credentials and routing.

Install @alter-ai/sdk @alter-ai/deel with npm, or alter-sdk-deel with pip. Supply your connected customer’s grant ID and the arguments described below.

import { App } from "@alter-ai/sdk";
import { DeelIntegration } from "@alter-ai/deel";
async function execute(input: Parameters<DeelIntegration["itAssets"]["deliverItAsset"]>[0]) {
const app = new App({ apiKey: process.env.ALTER_API_KEY! });
try {
const provider = new DeelIntegration(app, { grantId: process.env.PROVIDER_GRANT_ID! });
const call = await provider.itAssets.deliverItAsset(input);
const result = await call.wait();
return result.bodyJson();
} finally {
await app.close();
}
}
import os
from alter_sdk import App
from alter_sdk_deel import DeelIntegration
async def execute(arguments):
async with App(api_key=os.environ["ALTER_API_KEY"]) as app:
provider = DeelIntegration(app, {"grant_id": os.environ["PROVIDER_GRANT_ID"]})
call = await provider.it_assets.deliver_it_asset(arguments)
result = await call.wait()
return result.body_json()
FieldTypePresenceDescription and constraints
$objectRootAdditional keys: not allowed
pathobjectRequired within parentAdditional keys: not allowed
path.asset_idstringRequired within parentFormat: uuid
headersobjectRequired within parentAdditional keys: not allowed
headers.X-BetastringRequired within parentDefault: true
One of: true
bodyobjectOptional
body.dataModelRequired within parentExpand Create a delivery request for an IT asset — request body — body data

Referenced models: Create a delivery request for an IT asset — request body — body data

Response media type: application/json. The table describes the pinned successful response. Referenced models link to their complete fields.

FieldTypePresenceDescription and constraints
$ModelRootExpand Update asset — 200 response body

Referenced models: Update asset — 200 response body

73 more schemas are linked from the tables above, on the schema pages.

Create a delivery request for an IT asset — request body — body data
FieldTypePresenceDescription and constraints
$objectRoot
delivery_addressModelOptionalExpand Create a delivery request for an IT asset — request body — body data delivery address
Delivery address for the recipient. Optional when the HRIS profile already has a valid delivery address on file.
hris_profile_idstringRequired within parentHRIS profile identifier of the recipient.
Format: uuid
is_express_deliverybooleanRequired within parentWhether express delivery is requested. Defaults to false. Charges an express fee where the country supports express delivery.
shipment_insuranceModelOptionalExpand Create a delivery request for an IT asset — request body — body data shipment insurance
Insurance-consent flag and optional purchase details Deel records against the asset. Required for every asset, including one already at a Deel warehouse. Send either purchase details or a waiver. With `is_waived` false, purchase details may be left out only if the asset already has a purchase price and date on record.

Referenced models: Create a delivery request for an IT asset — request body — body data delivery address, Create a delivery request for an IT asset — request body — body data shipment insurance

Update asset — 200 response body
FieldTypePresenceDescription and constraints
$objectRoot
dataModelRequired within parentExpand Update asset — 200 response body — data

Referenced models: Update asset — 200 response body — data

Create a delivery request for an IT asset — request body — body data delivery address
FieldTypePresenceDescription and constraints
$objectRootDelivery address for the recipient. Optional when the HRIS profile already has a valid delivery address on file.
citystringOptionalCity name
countryModelRequired within parentExpand Assign asset to new holder — request body — body data delivery address country
Country code (ISO 3166 alpha-2)
date_of_birthstringOptionalDate of birth
Format: date
delivery_instructionsstringOptionalDelivery instructions for the courier
line1stringOptionalAddress line 1
line2stringOptionalAddress line 2
passport_numberstringOptionalPassport number
phone_numberstringOptionalPhone number in E.164 format
post_codestringOptionalPost code
statestringOptionalState or region name
tax_id_numberstringOptionalTax ID number

Referenced models: Assign asset to new holder — request body — body data delivery address country

Create a delivery request for an IT asset — request body — body data shipment insurance
FieldTypePresenceDescription and constraints
$objectRootInsurance-consent flag and optional purchase details Deel records against the asset. Required for every asset, including one already at a Deel warehouse. Send either purchase details or a waiver. With `is_waived` false, purchase details may be left out only if the asset already has a purchase price and date on record.
is_waivedbooleanRequired within parentConsent to ship without insurance. When true, `purchase_details` must be omitted and Deel will not record a purchase price against the asset.
purchase_detailsModelOptionalExpand Assign asset to new holder — request body — body data shipment insurance purchase details
Purchase details Deel records against the asset. Omit to fall back to purchase details already stored on the asset, if any. Must be omitted when `is_waived` is true.

Referenced models: Assign asset to new holder — request body — body data shipment insurance purchase details

Update asset — 200 response body — data
FieldTypePresenceDescription and constraints
$objectRoot
actionsModelRequired within parentExpand Update asset — 200 response body — data actions
Actions the caller can execute on this asset, with availability status per action
assigned_userJSONRequired within parentDetails of the user with asset possession
assigned_user (anyOf 1)ModelAlternativeExpand Update asset — 200 response body — data assigned user Details of the user with asset possession
assigned_user (anyOf 2)nullAlternative
assigned_warehouseJSONRequired within parentDetails of the warehouse with asset possession
assigned_warehouse (anyOf 1)ModelAlternativeExpand Update asset — 200 response body — data / assigned_warehouse / ownership: DEEL, ORGANIZATION, warehouse type: CLEARANCE, DEEL, ORGANIZATION
assigned_warehouse (anyOf 2)nullAlternative
created_atstringRequired within parentCreation timestamp of the asset
Format: date-time
gradestringRequired within parentThe condition grade of the asset
Known values: A, B, C, D, F, NEW
idstringRequired within parentUnique identifier of the item
Format: uuid
keyboard_layoutJSONRequired within parentKeyboard layout of the asset, null when none is recorded
keyboard_layout (anyOf 1)ModelAlternativeExpand Update asset — 200 response body — data keyboard layout string
keyboard_layout (anyOf 2)nullAlternative
locationstringRequired within parentCurrent location type of the asset
Known values: AT_WAREHOUSE, CLEARANCE_WAREHOUSE, DEEL_WAREHOUSE, ORGANIZATION_WAREHOUSE, SUPPLIER, WITH_COURIER, WITH_USER, WRITE_OFF
operating_systemJSONRequired within parentOperating system of the asset, null when none is recorded
operating_system (anyOf 1)stringAlternativeOperating system of the asset, null when none is recorded
Known values: ANDROID_PHONE, ANDROID_TABLET, CHROME_OS, IOS_PHONE, IOS_TABLET, LINUX, MACOS, WINDOWS
operating_system (anyOf 2)nullAlternative
ownershipModelRequired within parentExpand Update asset — 200 response body — data ownership
Asset owner
productModelRequired within parentExpand Update asset — 200 response body — data product
Product details
public_idstringRequired within parentPublic identifier of the item
purchase_dateJSONRequired within parent
purchase_date (anyOf 1)stringAlternativePurchase date of the asset
Format: date
purchase_date (anyOf 2)nullAlternativePurchase date of the asset
Format: date
purchase_valueJSONRequired within parentPurchase value of the asset
purchase_value (anyOf 1)ModelAlternativeExpand Update asset — 200 response body — data purchase value Purchase value of the asset
purchase_value (anyOf 2)nullAlternative
serial_numberJSONRequired within parent
serial_number (anyOf 1)stringAlternativeAsset serial number
serial_number (anyOf 2)nullAlternativeAsset serial number
statusModelRequired within parentExpand Update asset — 200 response body — data status
Current state of the asset
updated_atstringRequired within parentLast update timestamp of the asset
Format: date-time

Referenced models: Update asset — 200 response body — data assigned user Details of the user with asset possession, Update asset — 200 response body — data actions, Update asset — 200 response body — data / assigned_warehouse / ownership: DEEL, ORGANIZATION, warehouse type: CLEARANCE, DEEL, ORGANIZATION, Update asset — 200 response body — data keyboard layout string, Update asset — 200 response body — data ownership, Update asset — 200 response body — data product, Update asset — 200 response body — data purchase value Purchase value of the asset, Update asset — 200 response body — data status

Assign asset to new holder — request body — body data delivery address country
FieldTypePresenceDescription and constraints
$stringRootCountry code (ISO 3166 alpha-2)
One of: AD, AE, AF, AG, AI, AL, AM, AN, AO, AQ, AR, AS, AT, AU, AW, AX, AZ, BA, BB, BD, BE, BF, BG, BH, BI, BJ, BL, BM, BN, BO, BQ, BR, BS, BT, BV, BW, BY, BZ, CA, CC, CD, CF, CG, CH, CI, CK, CL, CM, CN, CO, CR, CU, CV, CW, CX, CY, CZ, DE, DJ, DK, DM, DO, DZ, EC, EE, EG, EH, ER, ES, ET, FI, FJ, FK, FM, FO, FR, GA, GB, GD, GE, GF, GG, GH, GI, GL, GM, GN, GP, GQ, GR, GS, GT, GU, GW, GY, HK, HM, HN, HR, HT, HU, IC, ID, IE, IL, IM, IN, IO, IQ, IR, IS, IT, JE, JM, JO, JP, KE, KG, KH, KI, KM, KN, KP, KR, KW, KY, KZ, LA, LB, LC, LI, LK, LR, LS, LT, LU, LV, LY, MA, MC, MD, ME, MF, MG, MH, MK, ML, MM, MN, MO, MP, MQ, MR, MS, MT, MU, MV, MW, MX, MY, MZ, NA, NC, NE, NF, NG, NI, NL, NO, NP, NR, NU, NZ, OM, PA, PE, PF, PG, PH, PK, PL, PM, PN, PR, PS, PT, PW, PY, QA, RE, RO, RS, RU, RW, SA, SB, SC, SD, SE, SG, SH, SI, SJ, SK, SL, SM, SN, SO, SR, SS, ST, SV, SX, SY, SZ, TC, TD, TF, TG, TH, TJ, TK, TL, TM, TN, TO, TR, TT, TV, TW, TZ, UA, UG, US, UY, UZ, VA, VC, VE, VG, VI, VN, VU, WF, WS, XK, YE, YT, ZA, ZM, ZW

SDK function policy ID: deel.itassets_deliveritasset_v2026_09_15. Catalog operation: itassets_deliveritasset_v2026_09_15. Rules can name either ID; function rules distinguish managed calls and conservatively cover raw calls sharing the route. Existing grant permissions and policy rules apply. wait() returns an immediate result or waits for a required approval; it never approves the request itself. Persist the approval ID to resume after a restart.

Provider errors retain their response; JSON decoding raises ProviderAPIError for provider failures. ManagedOperationError identifies contract/input/retention errors. See error handling and provider-specific behavior. Sensitive input may be refused before approval storage. A decoding error never resubmits a write.

Required provider scopes: ["it-service-requests:write"]

Pinned headers: {"X-Version": "2026-09-15"}

Official provider source

Report an issue with this page

Necessary

Required for sign-in, security, authorization, and remembering your choices.

Always active

Analytics

Helps us understand which product and documentation features are useful.

Performance diagnostics

Uses performance tracing and privacy-masked session replay to diagnose problems.

You can change these choices at any time from Cookie settings.