---
title: "Returns metadata about a piece of media"
method: GET
path: "/v1/org/{orgId}/media/{mediaId}"
tags: ["media"]
---

# Returns metadata about a piece of media

`GET /v1/org/{orgId}/media/{mediaId}`

## Request

- Base URL: `https://localhost`
- URL: `https://localhost/v1/org/{orgId}/media/{mediaId}`
- Auth: none declared

## Path parameters

- `orgId` string, required
- `mediaId` string, required

## Response `200`

successful operation

- Media
  - `id` string, required: globally unique id of media
  - `orgId` string: parent org id, if the media belongs to an organization
  - `path` string, required: path to the file in media S3 bucket
  - `type` string, required: mime type of file
  - `bytes` integer: size of file in bytes
  - `width` integer: width of image in pixels
  - `height` integer: height of image in pixels
  - `versions` string[], required: versions/sizes available
  - `createId` string, required: created by user id
  - `createBehalfId` string: created on behalf of user id
  - `createAttribution` Attribution
    - `principalUserId` string
    - `agentUserIds` string[]
    - `eventId` string
    - `aiChatId` string
    - `aiToolUseId` string
    - `channel` 'WEB' | 'MOBILE' | 'SLACK' | 'TEAMS' | 'MCP'
  - `createAt` string, required: created timestamp

## Other responses

- `401`: Not authorized
- `403`: Permission denied
- `404`: Media not found

---

[API](https://skmtc.dev/charthop/apis/charthop-api.md) · [All operations](https://skmtc.dev/charthop/apis/charthop-api/llms.txt) · [OpenAPI document](https://skmtc.dev/charthop/apis/charthop-api/revisions/408971534d3f?raw)