SweetConnect LogoSweetConnect
ApiAsset documents

Create a link between a file and an asset

Access restricted to roles:

  • admin
  • manufacturer-admin
  • manufacturer-user
  • producer-admin
  • producer-user
POST
/v1/documents/assets/{fileId}/{assetId}/{assetOrganizationId}
AuthorizationBearer <token>

In: header

Path Parameters

fileId*string

The unique identifier of the file

assetId*string

The unique identifier of the asset

assetOrganizationId*string

The unique identifier of the organization of that asset

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://test.sweetconnect.io/api/storage/v1/documents/assets/string/string/string"
{
  "data": {
    "id": "a3f2b65e-4f22-4f45-80c4-9e547a8f5e6a",
    "filename": "document.pdf",
    "displayname": "Manual 2025",
    "ownerId": "d1f2g3h4-i5j6-k7l8-m9n0",
    "organizationId": "d1f2g3h4-i5j6-k7l8-m9n0",
    "manufacturerId": "d1f2g3h4-i5j6-k7l8-m9n0",
    "mimetype": "application/pdf",
    "category": {
      "id": "AA",
      "languageCode": "en",
      "name": "Electronics"
    },
    "languages": [
      "de",
      "fr"
    ],
    "updatedAt": "2025-02-27T12:00:00.000Z",
    "updatedBy": "user-1234abcd",
    "createdBy": "user-5678efgh",
    "createdAt": "2025-01-15T09:30:00.000Z",
    "supplierDocument": false,
    "supplierName": "Amcor",
    "aiInjected": "uninjected",
    "aiInjectedUpdatedAt": "2025-02-27T14:30:00.000Z"
  }
}
{
  "errors": [
    {
      "errorCode": "BadRequest",
      "message": "The request payload is invalid.",
      "extension": {}
    }
  ]
}
{
  "errors": [
    {
      "errorCode": "Unauthorized",
      "message": "Authentication is required to access this resource.",
      "extension": {}
    }
  ]
}
{
  "errors": [
    {
      "errorCode": "NoPermission",
      "message": "You do not have permission to access this resource.",
      "extension": {}
    }
  ]
}
{
  "errors": [
    {
      "errorCode": "NotFound",
      "message": "The requested resource was not found.",
      "extension": {}
    }
  ]
}
{
  "errors": [
    {
      "errorCode": "InternalServerError",
      "message": "An unexpected internal server error occurred.",
      "extension": {}
    }
  ]
}