Attach file to a specific asset.

Endpoint URL

https://{{base_url}}/api/v2/asset_attachment

Authentication and rate limits

ItemDetails
Authentication methodOAuth 2.0 Bearer token
Rate limitRate Limit

Requests Example

curl --request POST \
  --url 'https://{{base_url}}/api/v2/asset_attachment \
  --header 'Authorization: Bearer $BEARER_TOKEN' \
  --header 'Content-Type: application/json' \
  --data-raw '$JSON'

Request Syntax

{
    "company":integer,
    "asset_id":integer,
    "file_type":"asset_attachments" | "warranty_document" | "support_document",
    "file_id": integer
}

Body Parameters

  • company (integer) --

    [REQUIRED]
    The ID of the specific company your API is calling. For accounts with only one company, the default value is 1.
    To lookup a specific company ID, see the List Company API.

  • asset_id (integer) --

    [REQUIRED]
    The ID of the asset. <
    To lookup a specific asset ID, see the List Asset API.

  • file_type (string) --

    [REQUIRED]
    Specify the type of attachment to be added to an asset.
    Options: asset_attachments | warranty_document | support_document

  • file_id (integer) --

    [REQUIRED]
    The ID of the file that was uploaded. <
    To lookup a specific file ID, see the List File API.

Response Syntax

{
    "details": {
        "status": "linked successfully",
        "file_uuid": "string",
        "contract_id": integer,
        "file_id": integer,
        "file_type":"asset_attachments" | "warranty_document" | "support_document"
    }
}