# Listrak Media API

> REST API for managing a company's media library - directories and image files - and listing the fonts available alongside them.
> Base URL `https://api.listrak.com/media`. Auth: OAuth2 client_credentials at `https://auth.listrak.com/OAuth2/Token` (Bearer token).
> This documentation is plain markdown, designed to be fetched and read directly by coding agents.

## Start here
- [Getting started](https://api-docs.tools.listrak.com/media/guides/getting-started.md): get a token, walk the directory tree, upload a file, list fonts
- [Authentication (OAuth2)](https://api-docs.tools.listrak.com/media/guides/authentication.md): client_credentials with Media integration credentials; the Media role and company claims
- [Errors & retries](https://api-docs.tools.listrak.com/media/guides/errors.md): error codes, which statuses are retryable, and why a blind upload retry can 409
- [PII & logging](https://api-docs.tools.listrak.com/media/guides/pii-logging.md): file names and public URLs are customer content - log ids, not names
- [Copy-paste client & recipes](https://api-docs.tools.listrak.com/media/guides/recipes.md): full Python client, tree walk with paging, multipart upload, move and rename

## Other resources
- [Directories](https://api-docs.tools.listrak.com/media/reference/directories.md): Directories
- [Files](https://api-docs.tools.listrak.com/media/reference/files.md): Files
- [Fonts](https://api-docs.tools.listrak.com/media/reference/fonts.md): Fonts

## Optional
- [Full reference (single file)](https://api-docs.tools.listrak.com/media/llms-full.txt): everything concatenated
- [OpenAPI spec](https://api-docs.tools.listrak.com/media/openapi.json): machine-readable OpenAPI 3.x