Atomicwork Assets API

The assets API from Atomicwork — 7 operation(s) for assets.

GitHub OpenAPI
Business capability
IT Service Management BC-600.30

Operations 10

POST /api/v1/assets Create Asset #
GET /api/v1/assets/attributes Get List of all Asset attributes #
POST /api/v1/assets/list Asset List with views, and filters #
GET /api/v1/assets/users/{user_id}/list Get List of Assets for a user #
GET /api/v1/assets/types/{asset_type_id}/form-fields Get Form Fields of an AssetType #
GET /api/v1/assets/{asset_id} Get Asset Details #
PUT /api/v1/assets/{asset_id} Update Asset #
DELETE /api/v1/assets/{asset_id} Delete Asset #
PATCH /api/v1/assets/{asset_id} Partially update an asset (RFC 7386 JSON Merge Patch) #
GET /api/v1/assets/{asset_id}/activities Get Asset Activities #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/atomicwork:atomicwork-assets-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

atomicwork-assets-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Atomicwork Public Assets API
  version: 1.0.0
servers:
- url: https://{tenant}.atomicwork.com
  description: Your Atomicwork tenant
tags:
- name: Assets
paths:
  /api/v1/assets:
    post:
      operationId: assets_postapi_v1_assets
      summary: Create Asset
      tags:
      - Assets
      parameters:
      - name: X-Workspace-Id
        in: header
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Assets_postapi_v1_assets_Response_200'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                asset_type_id:
                  type: integer
                  format: int64
                form_fields:
                  $ref: '#/components/schemas/ApiV1AssetsPostRequestBodyContentApplicationJsonSchemaFormFields'
                image_id:
                  type: integer
                  format: int64
              required:
              - asset_type_id
              - form_fields
      security:
      - ApiKeyAuth: []
  /api/v1/assets/attributes:
    get:
      operationId: assets_getapi_v1_assets_attributes
      summary: Get List of all Asset attributes
      tags:
      - Assets
      parameters:
      - name: search_key
        in: query
        description: Search String
        required: false
        schema:
          type: string
      - name: asset_type
        in: query
        description: asset_type
        required: false
        schema:
          type: integer
          format: int64
      - name: page
        in: query
        description: limit
        required: false
        schema:
          type: integer
          minimum: 1
          default: 1
      - name: page_size
        in: query
        description: offset
        required: false
        schema:
          type: integer
          minimum: 1
          default: 25
      - name: X-Workspace-Id
        in: header
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Assets_getapi_v1_assets_attributes_Response_200'
      security:
      - ApiKeyAuth: []
  /api/v1/assets/list:
    post:
      operationId: assets_postapi_v1_assets_list
      summary: Asset List with views, and filters
      description: '### Filtering


        The request body is an **array of filter objects**. Send an empty array (`[]`) to retrieve all records.


        Each filter object has the following fields:


        | Field | Type | Description |

        |---|---|---|

        | `attribute` | string | The field to filter on (see Supported attributes below) |

        | `operator` | string | Comparison operator (see Available operators below) |

        | `values` | array | One or more `{ "value": }` objects |


        **Supported attributes**


        | Attribute | Typical operator | Description |

        |---|---|---|

        | `status` | `IS_ANY_OF` | Asset status (e.g. `IN_USE`, `AVAILABLE`, `RETIRED`). |

        | `type_id` | `IS_ANY_OF` | Asset type ID. |

        | `assigned_to_id` | `IS_ANY_OF` | User ID the asset is assigned to. |


        **Available operators**


        | Operator | Meaning |

        |---|---|

        | `EQUALS` | Exact match |

        | `NOT_EQUALS` | Exclude exact match |

        | `IN` / `IS_ANY_OF` | Match any value in the list |

        | `IS_NOT_ANY_OF` | Exclude all listed values |

        | `IS_BETWEEN` | Inclusive range — pass exactly two values: `[start, end]` |

        | `IS_ON_OR_BEFORE` / `IS_ON_OR_AFTER` | Date/time boundary comparisons |

        | `CONTAINS` / `TEXT_CONTAINS` | Substring or set membership |

        | `IS_NULL` / `IS_NOT_NULL` | Null checks — `values` array can be empty |

        | `STARTS_WITH` / `ENDS_WITH` | String prefix/suffix match |


        **Example**


        ```json

        [

        {

        "attribute": "status",

        "operator": "IS_ANY_OF",

        "values": [

        {

        "value": "IN_USE"

        },

        {

        "value": "AVAILABLE"

        }

        ]

        }

        ]

        ```'
      tags:
      - Assets
      parameters:
      - name: sort_order
        in: query
        description: ''
        required: false
        schema:
          $ref: '#/components/schemas/ApiV1AssetsListPostParametersSortOrder'
      - name: sort
        in: query
        description: 'Generic multi-column sort, comma-separated `field:DIRECTION` (e.g. `display_name:ASC,created_at:DESC`). Sortable fields are those advertised with `sortable: true` by the asset fields endpoint. Takes precedence over `sort_order`. Invalid/unknown fields -> 400.'
        required: false
        schema:
          type: string
          maxLength: 256
      - name: page
        in: query
        description: ''
        required: true
        schema:
          type: integer
          minimum: 1
          default: 1
      - name: per_page
        in: query
        description: ''
        required: false
        schema:
          type: integer
          minimum: 1
          maximum: 1000
          default: 25
      - name: X-Workspace-Id
        in: header
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Assets_postapi_v1_assets_list_Response_200'
      requestBody:
        content:
          application/json:
            schema:
              type: array
              items:
                $ref: '#/components/schemas/ApiV1AssetsListPostRequestBodyContentApplicationJsonSchemaItems'
      security:
      - ApiKeyAuth: []
  /api/v1/assets/users/{user_id}/list:
    get:
      operationId: assets_getapi_v1_assets_users__user_id__list
      summary: Get List of Assets for a user
      tags:
      - Assets
      parameters:
      - name: user_id
        in: path
        description: userId
        required: true
        schema:
          type: integer
          format: int64
      - name: search_key
        in: query
        description: Search String
        required: false
        schema:
          type: string
      - name: page
        in: query
        description: limit
        required: false
        schema:
          type: integer
          minimum: 1
          default: 1
      - name: page_size
        in: query
        description: offset
        required: false
        schema:
          type: integer
          minimum: 1
          default: 25
      - name: X-Workspace-Id
        in: header
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Assets_getapi_v1_assets_users__user_id__list_Response_200'
      security:
      - ApiKeyAuth: []
  /api/v1/assets/types/{asset_type_id}/form-fields:
    get:
      operationId: assets_getapi_v1_assets_types__asset_type_id__form_fields
      summary: Get Form Fields of an AssetType
      tags:
      - Assets
      parameters:
      - name: asset_type_id
        in: path
        description: assetTypeId
        required: true
        schema:
          type: integer
          format: int64
      - name: source
        in: query
        description: 'Optional. When provided (e.g. "KANDJI", "MS_INTUNE", "JAMF"), filters the returned

          form fields to only those mapped to that integration source — used by the per-source

          asset detail view to render only the fields the source contributes. When omitted,

          returns the full field set for the asset type (current behavior).

          '
        required: false
        schema:
          type: string
      - name: X-Workspace-Id
        in: header
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Assets_getapi_v1_assets_types__asset_type_id__form_fields_Response_200'
      security:
      - ApiKeyAuth: []
  /api/v1/assets/{asset_id}:
    get:
      operationId: assets_getapi_v1_assets__asset_id
      summary: Get Asset Details
      tags:
      - Assets
      parameters:
      - name: asset_id
        in: path
        description: assetId
        required: true
        schema:
          type: integer
          format: int64
      - name: source
        in: query
        description: 'Optional. When provided (e.g. "KANDJI", "MS_INTUNE", "JAMF"), returns the asset''s

          view from that integration''s source-original ledger row instead of the merged unified

          view. The response''s asset_basic_info.id stays as the unified id (URL is canonical);

          asset_basic_info.source still reflects the unified''s origin; form_fields and per-row

          timestamps reflect the source''s contribution. Returns 404 if the asset has no

          contribution from the requested source. See asset_basic_info.additional_sources for

          the list of valid source values for this asset.

          '
        required: false
        schema:
          type: string
      - name: X-Workspace-Id
        in: header
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Assets_getapi_v1_assets__asset_id_Response_200'
      security:
      - ApiKeyAuth: []
    put:
      operationId: assets_putapi_v1_assets__asset_id
      summary: Update Asset
      tags:
      - Assets
      parameters:
      - name: asset_id
        in: path
        description: assetId
        required: true
        schema:
          type: integer
          format: int64
      - name: X-Workspace-Id
        in: header
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Assets_putapi_v1_assets__asset_id_Response_200'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                asset_type_id:
                  type: integer
                  format: int64
                form_fields:
                  $ref: '#/components/schemas/ApiV1AssetsAssetIdPutRequestBodyContentApplicationJsonSchemaFormFields'
                image_id:
                  type: integer
                  format: int64
              required:
              - asset_type_id
              - form_fields
      security:
      - ApiKeyAuth: []
    delete:
      operationId: assets_deleteapi_v1_assets__asset_id
      summary: Delete Asset
      tags:
      - Assets
      parameters:
      - name: asset_id
        in: path
        description: assetId
        required: true
        schema:
          type: integer
          format: int64
      - name: X-Workspace-Id
        in: header
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Assets_deleteapi_v1_assets__asset_id_Response_200'
      security:
      - ApiKeyAuth: []
    patch:
      operationId: assets_patchapi_v1_assets__asset_id
      summary: Partially update an asset (RFC 7386 JSON Merge Patch)
      description: 'Partially updates an asset using JSON Merge Patch semantics (RFC 7386). Send only the

        fields you want to change under `form_fields`: a field present with a value sets it, a field

        present with `null` clears it, and an omitted field is left untouched. Unlike PUT, you do

        not need to resend the entire form. Concurrent updates are guarded by optimistic locking and

        retried automatically.'
      tags:
      - Assets
      parameters:
      - name: asset_id
        in: path
        description: assetId
        required: true
        schema:
          type: integer
          format: int64
      - name: X-Workspace-Id
        in: header
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Assets_patchapi_v1_assets__asset_id_Response_200'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties: {}
      security:
      - ApiKeyAuth: []
  /api/v1/assets/{asset_id}/activities:
    get:
      operationId: assets_getapi_v1_assets__asset_id__activities
      summary: Get Asset Activities
      tags:
      - Assets
      parameters:
      - name: asset_id
        in: path
        description: assetId
        required: true
        schema:
          type: integer
          format: int64
      - name: page
        in: query
        description: ''
        required: true
        schema:
          type: integer
          minimum: 1
          default: 1
      - name: per_page
        in: query
        description: ''
        required: false
        schema:
          type: integer
          minimum: 1
          maximum: 100
          default: 25
      - name: next_page_token
        in: query
        description: ''
        required: false
        schema:
          type: string
      - name: source
        in: query
        description: 'Optional. When provided (e.g. "KANDJI", "MS_INTUNE", "JAMF"), returns the activity

          log of that integration''s source-original ledger row instead of the unified row''s

          activity log. Source-original entries capture each individual sync''s changes;

          unified entries capture derive-driven aggregations. Returns 404 if the asset has no

          contribution from the requested source.

          '
        required: false
        schema:
          type: string
      - name: X-Workspace-Id
        in: header
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Assets_getapi_v1_assets__asset_id__activities_Response_200'
      security:
      - ApiKeyAuth: []
components:
  schemas:
    Assets_getapi_v1_assets_attributes_Response_200:
      type: object
      properties: {}
      description: Empty response body
      title: Assets_getapi_v1_assets_attributes_Response_200
    ApiV1AssetsListPostRequestBodyContentApplicationJsonSchemaItemsOperator:
      type: string
      enum:
      - EQUALS
      - NOT_EQUALS
      - CONTAINS
      - NOT_CONTAINS
      - IN
      - NOT_IN
      - GREATER_THAN
      - LESS_THAN
      - GREATER_THAN_EQUALS
      - LESS_THAN_EQUALS
      - IS_BETWEEN
      - IS_NULL
      - IS_NOT_NULL
      - STARTS_WITH
      - ENDS_WITH
      - TEXT_CONTAINS
      - TEXT_DOES_NOT_CONTAINS
      - IS_ANY_OF
      - IS_NOT_ANY_OF
      - IS_EXACTLY
      - IS_ON_OR_BEFORE
      - IS_ON_OR_AFTER
      - IS_WITHIN
      title: ApiV1AssetsListPostRequestBodyContentApplicationJsonSchemaItemsOperator
    Assets_putapi_v1_assets__asset_id_Response_200:
      type: object
      properties: {}
      description: Empty response body
      title: Assets_putapi_v1_assets__asset_id_Response_200
    Assets_patchapi_v1_assets__asset_id_Response_200:
      type: object
      properties: {}
      description: Empty response body
      title: Assets_patchapi_v1_assets__asset_id_Response_200
    Assets_deleteapi_v1_assets__asset_id_Response_200:
      type: object
      properties: {}
      description: Empty response body
      title: Assets_deleteapi_v1_assets__asset_id_Response_200
    Assets_getapi_v1_assets_types__asset_type_id__form_fields_Response_200:
      type: object
      properties: {}
      description: Empty response body
      title: Assets_getapi_v1_assets_types__asset_type_id__form_fields_Response_200
    Assets_postapi_v1_assets_list_Response_200:
      type: object
      properties: {}
      description: Empty response body
      title: Assets_postapi_v1_assets_list_Response_200
    Assets_getapi_v1_assets__asset_id__activities_Response_200:
      type: object
      properties: {}
      description: Empty response body
      title: Assets_getapi_v1_assets__asset_id__activities_Response_200
    ApiV1AssetsListPostRequestBodyContentApplicationJsonSchemaItemsValuesItems:
      type: object
      properties:
        value:
          $ref: '#/components/schemas/ApiV1AssetsListPostRequestBodyContentApplicationJsonSchemaItemsValuesItemsValue'
          description: 'A bare scalar - number, string or boolean - never a JSON object or array. For relationship, entity-reference, or dropdown attributes pass the numeric option or entity id (e.g. 4009, not {"id": 4009}).'
        nested_filter:
          description: Any type
      title: ApiV1AssetsListPostRequestBodyContentApplicationJsonSchemaItemsValuesItems
    Assets_postapi_v1_assets_Response_200:
      type: object
      properties: {}
      description: Empty response body
      title: Assets_postapi_v1_assets_Response_200
    ApiV1AssetsListPostRequestBodyContentApplicationJsonSchemaItemsValuesItemsValue:
      type: object
      properties: {}
      description: 'A bare scalar - number, string or boolean - never a JSON object or array. For relationship, entity-reference, or dropdown attributes pass the numeric option or entity id (e.g. 4009, not {"id": 4009}).'
      title: ApiV1AssetsListPostRequestBodyContentApplicationJsonSchemaItemsValuesItemsValue
    ApiV1AssetsAssetIdPutRequestBodyContentApplicationJsonSchemaFormFields:
      type: object
      properties: {}
      title: ApiV1AssetsAssetIdPutRequestBodyContentApplicationJsonSchemaFormFields
    Assets_getapi_v1_assets_users__user_id__list_Response_200:
      type: object
      properties: {}
      description: Empty response body
      title: Assets_getapi_v1_assets_users__user_id__list_Response_200
    Assets_getapi_v1_assets__asset_id_Response_200:
      type: object
      properties: {}
      description: Empty response body
      title: Assets_getapi_v1_assets__asset_id_Response_200
    ApiV1AssetsListPostParametersSortOrder:
      type: string
      enum:
      - CREATED_AT_DESC
      - CREATED_AT_ASC
      - UPDATED_AT_DESC
      - NAME_ASC
      - NAME_DESC
      title: ApiV1AssetsListPostParametersSortOrder
    ApiV1AssetsListPostRequestBodyContentApplicationJsonSchemaItems:
      type: object
      properties:
        attribute:
          type: string
        operator:
          $ref: '#/components/schemas/ApiV1AssetsListPostRequestBodyContentApplicationJsonSchemaItemsOperator'
        values:
          type: array
          items:
            $ref: '#/components/schemas/ApiV1AssetsListPostRequestBodyContentApplicationJsonSchemaItemsValuesItems'
      title: ApiV1AssetsListPostRequestBodyContentApplicationJsonSchemaItems
    ApiV1AssetsPostRequestBodyContentApplicationJsonSchemaFormFields:
      type: object
      properties: {}
      title: ApiV1AssetsPostRequestBodyContentApplicationJsonSchemaFormFields
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-Api-Key
x-provenance:
  method: harvested
  publisher: Atomicwork
  source: https://support.atomicwork.com/openapi.json
  note: split by refine-openapis from the provider's own published document, verified by fetch (openapi/_original/*.fetch.json);
    stamped by stamp-openapi-provenance.py (roadmap#793)