Get Asset

API to retrieve the CDN URL for an existing asset

Get Asset

Endpoint

GET /v1/businesses/{businessId}/assets/{assetId}

Path Parameters

Parameter	Type	Required	Description
businessId	string	Yes	Your business ID (UUID format)
assetId	string	Yes	The asset ID to retrieve

Response

Field	Type	Description
cdnUri	string	CDN URL where the asset is accessible

Example

Request

curl -X GET "https://api.connectly.ai/v1/businesses/550e8400-e29b-41d4-a716-446655440000/assets/6ba7b810-9dad-11d1-80b4-00c04fd430c8" \
  -H "X-API-Key: your-api-key"

Response

{
  "cdnUri": "https://cdn.connectly.ai/assets/6ba7b810-9dad-11d1-80b4-00c04fd430c8"
}

Error Responses

Authentication Error (401)

{
  "code": 16,
  "message": "XASSET.UNAUTHENTICATED: missing or invalid API key"
}

Asset Not Found (404)

{
  "code": 5,
  "message": "XASSET.NOT_FOUND: asset not found"
}

Invalid Asset ID (400)

{
  "code": 3,
  "message": "XASSET.INVALID_ARGUMENT: invalid asset_id format"
}

Rate Limiting

This endpoint is limited to 100 requests per second. If the limit is exceeded, the API will return a 429 Too Many Requests response.