Delete Font

Learn how to delete a custom font from your workspace

Published

DELETE
/v1/brand-assets/fonts/delete/{id}
curl -X DELETE "https://api.orshot.com/v1/brand-assets/fonts/delete/<ID>" \
  -H "Authorization: Bearer <ORSHOT_API_KEY>"

Overview#

This endpoint allows you to delete a specific custom font from your workspace using its unique ID.

Endpoint
https://api.orshot.com/v1/brand-assets/fonts/delete/:id

Request#

JavaScript
await fetch("https://api.orshot.com/v1/brand-assets/fonts/delete/456", {
  method: "DELETE",
  headers: {
    "Content-Type": "application/json",
    Authorization: "Bearer <ORSHOT_API_KEY>",
  },
});
JSON
{
  "message": "Font successfully deleted",
  "id": "456"
}

Path Parameters#

ParameterTypeRequiredDescription
idNumberYesThe unique identifier of the font to delete

Error Responses#

Font Not Found (404)#

JSON
{
  "error": "Font not found"
}

Missing Font ID (400)#

JSON
{
  "error": "Font ID is required"
}

Unauthorized (403)#

JSON
{
  "error": "Access Forbidden"
}

Notes#

  • The font must belong to your workspace
  • Once deleted, fonts cannot be recovered
  • Templates using the deleted font will fall back to the default font
  • The font cache is automatically invalidated when a font is deleted

Query Parameters#

ParameterTypeRequiredDescription
embedIdStringNoEmbed instance ID. Pair with embedUserId to scope this call to one embed user
embedUserIdStringNoThe same userId your app passes to the embed URL. Requires embedId

Per-User Libraries#

Pass embedId and embedUserId together to target only that embed user's font, so one user's ID can never delete another's. This is how one embed serves many brands or tenants, each with its own brand space.

Omit them and this endpoint behaves exactly as documented above. See Per-User Brand Assets for the full picture.

Rate Limits#

  • 30 requests per minute per endpoint
Was this page helpful?

Ready to automate?

Start rendering images, PDFs and videos from your templates in under 2 minutes. Free plan, no credit card.

Get your API key
  • Image, PDF and video generation via API
  • Visual editor with AI and smart layouts
  • Zapier, Make, MCP and 50+ integrations
  • White-label embed for your own app
  • 100 free credits a month, no credit card required