---
updatedAt: 2026-01-28T15:14:03.000Z
---

Fetch the complete documentation index at: https://developer.connecteam.com/llms.txt. Use this file to discover all available pages before exploring further.

# Asset Metadata

Retrieve metadata for a specific asset, including permissions and assignments.

## Endpoint

| Method | Endpoint                   | Description        |
| :----- | :------------------------- | :----------------- |
| GET    | /assets/v1/asset/{assetId} | Get asset metadata |

***

## Path Parameters

| Parameter | Type    | Required | Description                    |
| :-------- | :------ | :------- | :----------------------------- |
| assetId   | integer | Yes      | Unique identifier of the asset |

***

## Example Request

```bash
curl --request GET \
  --url https://api.connecteam.com/assets/v1/asset/12345 \
  --header 'X-API-KEY: YOUR_API_KEY'
```

***

## Response

```json
{
  "requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "data": {
    "permissions": [
      {
        "userId": 9170357
      },
      {
        "userId": 9170358
      }
    ],
    "assignments": {
      "userIds": [9170359, 9170360, 9170361],
      "smartGroups": ["sg-marketing", "sg-sales"]
    }
  }
}
```

***

## Response Fields

### Root Object

| Field       | Type   | Description                  |
| :---------- | :----- | :--------------------------- |
| permissions | array  | Users with admin/edit access |
| assignments | object | Assignment details           |

### Permissions Object

| Field  | Type    | Description              |
| :----- | :------ | :----------------------- |
| userId | integer | User ID with permissions |

### Assignments Object

| Field       | Type  | Description                      |
| :---------- | :---- | :------------------------------- |
| userIds     | array | List of assigned user IDs        |
| smartGroups | array | List of assigned smart group IDs |

***

## Use Cases

### Audit Asset Access

Determine who has access to a specific asset for compliance or auditing purposes.

```javascript
async function auditAssetAccess(assetId) {
  const response = await fetch(
    `https://api.connecteam.com/assets/v1/asset/${assetId}`,
    { headers: { 'X-API-KEY': 'YOUR_API_KEY' } }
  );
  const data = await response.json();
  
  console.log('Admins:', data.data.permissions.map(p => p.userId));
  console.log('Assigned Users:', data.data.assignments.userIds);
  console.log('Assigned Groups:', data.data.assignments.smartGroups);
  
  return data.data;
}
```

### Check User Assignment

```javascript
async function isUserAssignedToAsset(assetId, userId) {
  const response = await fetch(
    `https://api.connecteam.com/assets/v1/asset/${assetId}`,
    { headers: { 'X-API-KEY': 'YOUR_API_KEY' } }
  );
  const data = await response.json();
  
  return data.data.assignments.userIds.includes(userId);
}

// Check if user 9170359 is assigned to asset 12345
const isAssigned = await isUserAssignedToAsset(12345, 9170359);
console.log('User is assigned:', isAssigned);
```

### Sync External Systems

```javascript
class AssetSyncService {
  constructor(apiKey) {
    this.apiKey = apiKey;
  }

  async getAssetMetadata(assetId) {
    const response = await fetch(
      `https://api.connecteam.com/assets/v1/asset/${assetId}`,
      { headers: { 'X-API-KEY': this.apiKey } }
    );
    return response.json();
  }

  async syncToExternalLMS(assetIds) {
    const results = [];
    
    for (const assetId of assetIds) {
      const { data } = await this.getAssetMetadata(assetId);
      
      // Sync to external system
      results.push({
        assetId,
        assignedUserCount: data.assignments.userIds.length,
        assignedGroupCount: data.assignments.smartGroups.length,
        adminCount: data.permissions.length
      });
    }
    
    return results;
  }
}

// Usage
const syncService = new AssetSyncService('YOUR_API_KEY');
const syncResults = await syncService.syncToExternalLMS([12345, 12346, 12347]);
console.log(syncResults);
```

***

## Error Responses

### 404 Not Found

**Asset not found:**

```json
{
  "detail": "Asset not found"
}
```

### 403 Forbidden

**No access to asset:**

```json
{
  "detail": "Access denied to this asset"
}
```

***

[API Reference](https://developer.connecteam.com/reference/)