Lytho's API enables developers to build applications with access to Lytho's Asset Management and statistics dashboard. This enables users to fully integrate Lytho in their workflow and processes. Use the documentation below to get started:



TABLE OF CONTENTS



Using Lytho API

Lytho API allows developers to request information from Lytho including Assets, Collections, Tags, Tag groups and Permissions.


Authentication

Every HTTP request made to Lytho API must be authenticated by Lytho. Lytho supports API keys to be able to authenticate and use the Lytho API. 


API Keys

An API key is bound to a specific Lytho tenant. Multiple API keys can be created and setup by a Lytho Admin this API key always needs to be send in the header of the API call and will be checked within Lytho API on validity. An API key can always be revoked by the Lytho tenant admin.





API Requests 

All API request must be made over HTTPS. The base URL for the request is https://openapi.lytho.io/v1/ The complete URL varies depending on the resource being accessed. See our detailed API documentation for exact URLs. 


Pagination

Pagination of Lytho API is the process of organizing the response results of an API call into multiple pages. When you do GET calls especially bulk requests using the GET API methods there is a high possibility of a large number of records being returned. To make handling large payloads easier, we provide you with a way to control the maximum number of responses through pagination. 


Every call that is capable of using pagination can be given the following two request parameters: 

  • Page, the page parameter contains the page you want to retrieve 
  • Size, the size parameter contains the number of records a single page will contain its defaulted to 20 and has a maximum of 50 


Update and remove data

Currently all API calls expect a complete object to be send back to update, if a field in the object is not present in the json the field will be removed and become an empty field within Lytho. At this moment partial updates are not possible.




Technical Documentation

You can find the technical documentation for Lytho Workflow's API here.




API Endpoints

The following endpoints have been created for the API:


Assets
  • Retrieve assets
  • Download assets

  • Upload assets (getUploadLink, finalizeUpload)

  • Update asset data

  • Delete assets

  • Add tags to assets

  • Remove tags from assets

  • Add permissions to assets

  • Remove permissions from assets

  • Retrieve collections

  • Update collections

  • Delete collections

  • Add assets to collections

  • Remove assets from collections

  • Add permissions to collections

  • Remove permissions from collections

  • Add custom metadata to assets

  • Remove custom metadata from assets

  • Update custom metadata to assets

Tags
  • Retrieve tags
  • Create tags

  • Update tags and translations for tags

  • Delete tags

  • Retrieve tag groups

  • Create tag groups

  • Update tag groups and translations for tag groups

  • Adding tags to tag groups

  • Removing tags from tag groups

  • Delete tag groups

Permissions
  • Retrieve permissions
  • Create permissions

  • Update permissions

  • Delete permissions




Use Cases Examples

File Storage & Sharing Tools (Google Drive, Dropbox, OneDrive, Box) 

Sync or migrate files to/from DAM, manage versioning, apply metadata automatically.


Project & Work Management Platforms (Jira, Asana, Smartsheet, Monday.com)

Link assets to tasks/projects, auto-upload final deliverables to DAM, trigger updates based on task status.


Communication & Collaboration Tools (Slack, Microsoft Teams)

Push notifications when assets are uploaded or updated, share asset links automatically in team channels.


Creative & Design Tools (Adobe Creative Cloud, Figma, Canva)

Pull approved assets into design tools, push final creatives back into DAM with correct metadata.


Sales & CRM Platforms (Salesforce, HubSpot, Zoho CRM)

Attach approved assets to deals, campaigns, or contacts; track usage by sales teams.


Web Content & CMS Tools (WordPress, Drupal, Sitecore, Kentico)

Publish DAM-hosted assets to websites, update imagery dynamically from DAM.


Calendaring & Scheduling Tools (Google Calendar, Outlook Calendar)

Use custom metadata to schedule asset lifecycle events (e.g., publish dates, expiration).


BI & Analytics Platforms (Domo, Tableau, Power BI)

Pull asset usage data and metadata for performance reporting and ROI analysis.


Customer Support & Knowledge Management (Zendesk, ServiceNow, Confluence)

Embed latest brand-approved visuals into help articles or ticket replies.





Error Handling 

The Lytho API uses HTTP status codes to reflect a successful or unsuccessful request. 2XX status codes are successful requests 4XX/5XX status codes represent an error took place. If you receive an error status code, check the body for an error code and message.


Status code
DescriptionMost likely cause
2XXSuccessful request
400Bad requestInvalid / missing data
401UnauthorizedInvalid / missing API key
403ForbiddenPerforming an action that's not permitted
404Not found

The resource doesn’t exist / wrong

endpoint 

409Conflict

Trying to overwrite a resource that

already exists

429Too many requestsHit an API rate limit
500Internal server errorAn error occurred on Lytho side


Rate Limits define the maximum number of requests that can be made by apps to the Lytho API in a given period of time. Lytho employs rate limits to ensure stability of the API service for all users and to prevent many types of abuse or inadvertent

usage. Cache responses whenever possible instead of frequently making the same request.


  • 20 requests / minute
  • and a daily rate limit of 30000 request / day


(this are the base rate limits, if needed we can look into specific requests for rate limit settings)