get-workspace-asset.md

title	Get workspace asset
description	Get workspace asset via Plane API. HTTP request format, parameters, scopes, and example responses for get workspace asset.
keywords	plane, plane api, rest api, api integration, assets, get workspace asset

Get workspace asset

GET /api/v1/workspaces/{workspace_slug}/assets/{asset_id}/

Get presigned URL for asset download

Path Parameters

The unique identifier of the asset.

The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL https://app.plane.so/my-team/projects/, the workspace slug is my-team.

Scopes

assets:read

curl -X GET \
  "https://api.plane.so/api/v1/workspaces/my-workspace/assets/asset-uuid/" \
  -H "X-API-Key: $PLANE_API_KEY" \
  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN"

import requests

response = requests.get(
    "https://api.plane.so/api/v1/workspaces/my-workspace/assets/asset-uuid/",
    headers={"X-API-Key": "your-api-key"}
)
print(response.json())

const response = await fetch("https://api.plane.so/api/v1/workspaces/my-workspace/assets/asset-uuid/", {
  method: "GET",
  headers: {
    "X-API-Key": "your-api-key",
  },
});
const data = await response.json();

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "design-spec.pdf",
  "type": "application/pdf",
  "asset_url": "https://cdn.example.com/workspace-assets/design-spec.pdf",
  "attributes": {
    "entity_type": "WORKSPACE"
  }
}