---
title: "Get an asset"
method: POST
path: "/v2beta/cms/asset/get"
tags: ["Assets"]
---

# Get an asset

`POST /v2beta/cms/asset/get`

## Request

- Base URL: `https://api.karte.io`
- URL: `https://api.karte.io/v2beta/cms/asset/get`
- Auth: HTTP bearer

Craft Cross CMSのアセットの情報を取得します。

#### Required Scope
APIの実行に必要なScopeです。
```
beta.cms.asset.get
```

#### Required Role
管理画面でScopeを追加する際に必要な権限です。
```
Craft Cross CMS > メディアライブラリの閲覧
```

## Headers

- `x-karte-api` string
- `authorization` string
- `content-type` string

## Request body

- object
  - `assetId` string, required: アセットのID

## Response `200`

A successful response.

- Asset
  - `id` string, required: アセットID
  - `sys` object, required
    - `createdAt` string, required: アセットの作成日時
    - `createdBy` string, required: アセット作成者のアカウントID
    - `updatedAt` string, required: アセットの更新日時
    - `updatedBy` string, required: アセットの更新者のアカウントID
    - `publishedAt` string, nullable: アセットの公開日時
  - `title` string, required: アセットのタイトル
  - `description` string, required: アセットの説明
  - `altText` string, required: アセットの代替テキスト
  - `tagIds` string[], required: アセットに紐づくタグのIDリスト
  - `file` object, required
    - `name` string, required: ファイル名
    - `mimeType` string, required: ファイルのMIMEタイプ
    - `src` string, required: アセットのソースURL
    - `size` number, required: ファイルサイズ（バイト）
    - `width` number: 画像の幅（画像の場合）。幅と高さを読み取れない画像では省略されます
    - `height` number: 画像の高さ（画像の場合）。幅と高さを読み取れない画像では省略されます

## Other responses

- `400`: Bad Request. CMS Management API 400 responses include a non-empty detail.

---

[API](https://skmtc.dev/karte/apis/cms-management.md) - [All operations](https://skmtc.dev/karte/apis/cms-management/llms.txt) - [OpenAPI document](https://skmtc.dev/karte/apis/cms-management/revisions/275f2d6496ec?raw)