# Obelism media

> Obelism media is the digital asset management (DAM) library every Obelism product shares: images, videos and documents per Space (one site or brand), in nested folders, with texts per language, a focal point, tags and Shopify products tagged on the image. Originals live on files.obelism.studio, protected by default; Obelism Content serves them resized on its own pages and delivery API.

**When to use Obelism media**

Reach for media when a user wants to:

- Keep a shop's or site's images, videos and documents in one library, sorted in folders, with alt text per language and a focal point that every crop respects.
- Sort uploads automatically by file name (upload rules), import or export many files' details as CSV, or share files with someone outside the Organization behind a password and a time window.
- Tag Shopify products on an image (with AI suggestions) and push files to the Shopify admin, or use the same files in Obelism Content's pages.

**How an agent should use it**

1. Connect the MCP server (https://media.obelism.studio/mcp, OAuth) or call the agent API with a bearer token; start with the organizations and spaces it lists.
2. Upload, move and describe files in a Space; editors may change files, any member of the Space may read them.
3. Errors are JSON problem details with a `code` and a `hint`; see the errors page.

## Docs

- [Agents and MCP](https://media.obelism.studio/docs/agents): Connect Claude, Codex, Cursor or any MCP client to Obelism media, and let it browse, describe, tag, sort and share the files in your image library.
- [Agent API](https://media.obelism.studio/docs/api/agent): Read and organize a Space's files over HTTP with a bearer token. List and search files, change details, add files from a URL, manage folders and create shares.
- [Errors](https://media.obelism.studio/docs/api/errors): Every error code the Obelism media agent API and MCP server answer with, as RFC 9457 problem JSON, and what to change before retrying the request.
- [Files in Content](https://media.obelism.studio/docs/files/in-content): How Obelism Content uses media's files. Picking them in entries, optimized image URLs for sites, alt text and focal point per use, and what a change updates.
- [Raw files](https://media.obelism.studio/docs/files/raw-files): How files.obelism.studio serves original files exactly as uploaded, protected by default, to signed-in members and through signed links that last minutes.
- [Getting started](https://media.obelism.studio/docs/getting-started): Sign in, open a Space's image library, upload your first files, sort them into folders and set their alt text and focal point in Obelism media.
- [Obelism media](https://media.obelism.studio/docs): Digital asset management for every Obelism product. An image library per Space with folders, alt text per language, focal points, shares and Shopify tagging.
- [A file's details](https://media.obelism.studio/docs/library/details): Set a file's title and alt text per language, its focal point and tags, and replace, make private or delete it in the Obelism media library.
- [Folders](https://media.obelism.studio/docs/library/folders): Organize a Space's files in nested folders, move them in bulk, filter by tag or Shopify product, and search the whole image library by file name.
- [Imports and exports](https://media.obelism.studio/docs/library/imports): Add many files to the image library from URLs, or edit titles, alt text, tags, folders and focal points in bulk, with a CSV from Excel, Numbers or Sheets.
- [Upload rules](https://media.obelism.studio/docs/library/rules): Sort uploads into folders and tag them automatically by file name, with patterns like SS26_{campaign}_*.jpg, starts or ends with, or a regular expression.
- [Shares](https://media.obelism.studio/docs/library/shares): Share original files or a whole folder with people outside your Organization through a password-protected link, open a week by default and a month at most.
- [Uploads](https://media.obelism.studio/docs/library/uploads): How Obelism media uploads files of any size in parts, where they land, and the size limits for replacing a file, importing from a URL and agent uploads.
- [Privacy & GDPR](https://media.obelism.studio/docs/privacy): Who can see which files in Obelism media, how originals and shares are protected, what media stores about files and people, and where your files are kept.
- [Shopify](https://media.obelism.studio/docs/shopify): Shopify product tagging for your image library. Place products on photos, accept AI suggestions, add files to products in Shopify and show shoppable hotspots.

## API

- [OpenAPI spec](https://media.obelism.studio/openapi.json): OpenAPI 3.1 description of the agent API

## Optional

- [Homepage](https://media.obelism.studio/index.md): what Obelism media is, what it keeps and its FAQ, as Markdown
- [Agent setup](https://media.obelism.studio/agent-setup.md): instructions an agent follows to connect the media MCP server for its user
- [Full docs as text](https://media.obelism.studio/llms-full.txt): every docs page concatenated
- [Obelism](https://www.obelism.studio/llms.txt): every Obelism product, and which one to use
- [Sitemap](https://media.obelism.studio/sitemap.xml)