POST /api/v2/it_asset_management/assets/jobs
Queues a background job to perform bulk actions on up to 100 asset records per request.
Takes a job object with two nested fields:
action, one of:"create""update""delete""delete_by_external_id"
items- For a
"create"action, an array of JSON objects representing the assets being created - For an
"update"action, an array of JSON objects representing the assets being updated (must includeidattribute) - For a
"delete"action, an array of strings representing Zendesk asset ids - For a
"delete_by_external_id"action, an array of strings representing external ids
- For a
Note: For create and update actions, the asset_type_id, status_id, and location_id fields can be specified using either the ID or the name of the resource. For example, you can use "asset_type_id": "01K9BW852KHGF59W0TM02J2F6H" or "asset_type": "Laptop".
Allowed For
- Admins
Response
This endpoint returns a job_status JSON object and queues a background job to do the work. Use the Show Job Status endpoint to check for the job's completion. Only a certain number of jobs can be queued or running at the same time. See Job limit for more information.
Servers
- https://{subdomain}.{domain}.com
Request headers
| Name | Type | Required | Description |
|---|---|---|---|
Content-Type |
String | Yes |
The media type of the request body.
Default value: "application/json" |
Request body fields
| Name | Type | Required | Description |
|---|---|---|---|
job |
Object | No | |
job.action |
String | No |
Valid values:
|
job.items[] |
Array | No |
An array of asset objects for job actions that create or update. An array of strings for job actions that delete. |
How to start integrating
- Add HTTP Task to your workflow definition.
- Search for the API you want to integrate with and click on the name.
- This loads the API reference documentation and prepares the Http request settings.
- Click Test request to test run your request to the API and see the API's response.