---
title: "Get asset metadata"
method: GET
path: "/assets/v1/asset/{assetId}"
tags: ["Assets:v1:Asset"]
---

# Get asset metadata

`GET /assets/v1/asset/{assetId}`

Retrieve all metadata associated with a specified asset.

## Path parameters

- `assetId` integer, required — The unique identifier of the asset.

## Response `200`

Successful Response

- APIResponseAssetResponse
  - `requestId` string
  - `data` AssetResponse, required
    - `permissions` AssetPermissions[] — The details of user IDs with access permissions to the asset.
      - `userId` integer, required — The unique identifiers who have permissions to the asset
      - `deepPermission` object — Granular per-feature permissions for this user on this asset. Keys depend on the feature (e.g. shift scheduler exposes view, add_and_edit_shifts, publish_shifts, edit_settings). Omitted entirely for assets whose feature has no granular permissions. Owners always receive a full-access object (every flag = true).
    - `assignments` AssetAssignments, required
      - `userIds` integer[], required — The unique identifiers of the assigned users to the asset
      - `smartGroups` string[], required — The unique identifiers of the assigned smart groups to the asset

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/connecteam/apis/connecteam-api-documentation.md) · [All operations](https://skmtc.net/connecteam/apis/connecteam-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/connecteam/connecteam-api-documentation/revisions/d8f7f302222e/schema)