Assets

Assets Management

Get jewellery-assets

get

Get list of jewellery-assets with pagination. Filters and sorting can be applied.

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

limitinteger · min: 10 · max: 100Required

No of of records to fetch.

Default: 20

offsetintegerRequired

Records to be fetched from this offset.

Default: 0

order_bystring · enumOptional

Sort records by field

Default: asset_noPossible values:

order_typestring · enumOptional

Order type - asc or desc.

Default: descPossible values:

Responses

200

OK

application/json

countintegerOptional

Total number of records

limitintegerOptional

Limit of records fetched

offsetintegerOptional

Offset of records fetched

403

Unauthorized

application/json

422

Unprocessable Entity

application/json

get

/assets

HTTPcURLJavaScriptPython

GET /api/jewellery/assets HTTP/1.1
Host: console.studio360.tech
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 159

{
  "limit": 20,
  "offset": 0,
  "order_by": "asset_no",
  "order_type": "desc",
  "filters": {
    "asset_type_code": "BN",
    "background_color": "B",
    "tags": [
      "text"
    ],
    "date": "2026-03-28"
  }
}

{
  "count": 1,
  "limit": 1,
  "offset": 1,
  "records": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "asset_no": 1,
      "asset_name": "text",
      "asset_type_code": "BN",
      "asset_type": "text",
      "background_color": "B",
      "tags": [
        "text"
      ],
      "fields": {
        "stock_number": "1234567890",
        "gross_weight": 2.5,
        "metal_type": "Gold",
        "metal_purity": "18K",
        "made_for": "Kids",
        "stone_weight": 1.2
      },
      "expires_at": "2026-03-28T03:06:35.279Z",
      "thumbnail": "https://example.com",
      "preview": "https://example.com",
      "video": {
        "embedded_url": "text",
        "standalone_url": "text",
        "multi_view_url": "text"
      },
      "date": "2026-03-28T03:06:35.279Z",
      "status": "PUBLISHED"
    }
  ]
}

Get a jewellery-asset

get

Get a jewellery-asset details by id

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idstring · uuidRequired

ID of the asset to fetch

Responses

200

OK

application/json

A jewellery asset for display

idstring · uuidRead-onlyRequired

Unique identifier of the asset

asset_nonumberRead-onlyRequired

A numeric identifier of the asset

asset_namestringRequired

Name of the asset

asset_type_codestring · enumRequired

Type of the asset i.e. Ring, Earring, Necklace etc. Values are:

• BN: Bangle
• BR: Bracelet
• E: Earring
• N: Necklace
• NE: Necklace + Earring
• NET: Necklace + Earring + Tikka
• P: Pendant
• R: Ring
• W: Watch
• D: Diamond
• A: Accessories

Possible values:

asset_typestringRequired

Type of the asset i.e. Ring, Earring, Necklace etc.

background_colorstring · enumRead-onlyRequired

Background color of the asset Values are:

• B: Black
• BM: Black-Matt
• W: White
• WM: White-Matt
• O: Other

Possible values:

tagsstring[]Required

Tags associated with the asset

expires_atstring · date-timeRequired

URL expiration date

thumbnailstring · uriRequired

Thumbnail url of the asset

previewstring · uriRequired

Animated preview url of the asset

datestring · date-timeOptional

Date of asset creation

statusstring · enumRequired

Status of the asset

Possible values:

403

Unauthorized

application/json

404

Asset not found

application/json

409

Asset details can not be viewed, when asset is in state

application/json

get

/assets/{id}

HTTPcURLJavaScriptPython

GET /api/jewellery/assets/{id} HTTP/1.1
Host: console.studio360.tech
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "asset_no": 1,
  "asset_name": "text",
  "asset_type_code": "BN",
  "asset_type": "text",
  "background_color": "B",
  "tags": [
    "text"
  ],
  "fields": {
    "stock_number": "1234567890",
    "gross_weight": 2.5,
    "metal_type": "Gold",
    "metal_purity": "18K",
    "made_for": "Kids",
    "stone_weight": 1.2
  },
  "expires_at": "2026-03-28T03:06:35.279Z",
  "thumbnail": "https://example.com",
  "preview": "https://example.com",
  "video": {
    "embedded_url": "text",
    "standalone_url": "text",
    "multi_view_url": "text"
  },
  "date": "2026-03-28T03:06:35.279Z",
  "status": "PUBLISHED"
}

Update a jewellery-asset

put

Update a jewellery-asset details by id.

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idstring · uuidRequired

ID of the asset to update

Body

application/json

Request schema for updating an asset

asset_namestring · max: 32Required

Name of the asset (unique). Allowed characters are alphabets, numbers, hyphen and underscore.

tagsstring[]Optional

Tags associated with the asset. Tag names should be registered at the settings section of your account.

Responses

200

Asset updated successfully

application/json

messagestringRequired

403

Unauthorized

application/json

404

Asset not found

application/json

409

Asset is not in editable state

application/json

422

Unprocessable Entity

application/json

put

/assets/{id}

HTTPcURLJavaScriptPython

PUT /api/jewellery/assets/{id} HTTP/1.1
Host: console.studio360.tech
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 173

{
  "asset_name": "text",
  "tags": [
    "text"
  ],
  "fields": {
    "stock_number": "1234567890",
    "gross_weight": 2.5,
    "metal_type": "Gold",
    "metal_purity": "18K",
    "made_for": "Kids",
    "stone_weight": 1.2
  }
}

{
  "message": "text"
}