Contact Us

If you still have questions or prefer to get help directly from an agent, please submit a request.
We’ll get back to you as soon as possible.

Please fill out the contact form below and we will reply as soon as possible.

  1. Fotoware Alto
    • 11.14 Schreckhorn
    • Terminology
    • Solutions
    • User Guide - Deutsch
    • User Guide - English
    • API Changelog
  2. Fotoware Veloz
    • Managing users and groups
    • Configuring archives
    • Configuring workflows
    • Configuring site behavior
    • Navigating and searching to find your assets
    • Working with your assets
    • Editing asset metadata
    • Uploading files
    • Version Control in Fotoware
    • Albums - Creating and sharing collections
    • Placing assets in a CMS
    • Working with the Fotoware Pro interface
    • Using the Fotoware plugins
    • Consent management
    • User guide to FotoWeb for iPad (Legacy)
    • Picture conferencing with FotoWeb Screens (Legacy)
    • What's what in Fotoware
    • GDPR
    • Fotoware Veloz releases
    • Activity Exports
    • Fotoware Example Workflows
  3. Fotostation
    • Getting started with Fotostation
    • Viewing, selecting and sorting files
    • Managing your assets with archives
    • Adding metadata to assets
    • Searching for assets
    • Working with your assets
    • Version Control in Fotostation
    • Automating tasks with Actions
    • Configuring metadata fields and editors
    • Configuring Fotostation
    • Configuring Fotostation for multi-user environments
    • Troubleshooting Fotostation
  4. Fotoware Flow
    • What is Flow?
    • Getting started
    • Flow dictionary
  5. Fotoware On-Premises
    • Getting started
    • Index Manager
    • FotoWeb
    • Color Factory
    • Connect
    • Operations Center Guide
  6. Integrations and APIs
    • The Fotoware API
    • Creating integrations using embeddable widgets
    • Authorizing applications using OAuth
    • Auto-tagging
    • FotoWeb Drag and Drop export
    • Integration using webhooks
    • Optimizely and Episerver plugin documentation
    • User Interface Integrations
  7. Fotoware Mobile
    • User guide for Fotoware Mobile for iPhone and Android
    • User guide to FotoWeb for iPad (Legacy)
    • User guide to FotoWeb for iPhone and Android (Legacy)

Contact Us

If you still have questions or prefer to get help directly from an agent, please submit a request.
We’ll get back to you as soon as possible.

Please fill out the contact form below and we will reply as soon as possible.

  • Support

Table of Contents

If you're using Fotoware Veloz If you're running Fotoware On-Premises Enabling CORS After registering the application and enabling CORS
  • Home
  • Integrations and APIs
  • The Fotoware API
  • Fotoware API Overview

Exploring the Fotoware API with Swagger

11. April 2025

Elaine Foley

Table of Contents

If you're using Fotoware Veloz If you're running Fotoware On-Premises Enabling CORS After registering the application and enabling CORS

Public documentation of the Fotoware endpoints with Swagger (OpenAPI) is available at https://api.fotoware.com. Using this site, you can authorize the site's connection to your Fotoware Veloz tenant and explore the entire API.

If you're using Fotoware Veloz

  1. Go to https://api.fotoware.com
  2. Add your Fotoware tenant's URL to the Site field at the top of the screen and select Authorize:


     
  3. Select Authorize again and log in to your site with a username and password (OAuth).

  4. When the authorization is complete, close the dialog box in the Swagger interface and explore the API!

If you're running Fotoware On-Premises

If you're running an on-premises version of Fotoware, you need to register the Fotoware API site as an application on your Fotoware site before you can authorize a connection: 

  1. From the Tools menu (cogwheel icon), go to Site Configuration > Integrations > Applications.
  2. Select Add application.
  3. Enter the following values: 
  • Type: Native
  • Scope: API
  • Client ID: 4d71615a-3bce-457a-a57c-3b5e54dcd075
  • Redirect URIs: Select Add to enter the redirect URI: https://api.fotoware.com/oauth2-redirect.html
  1. Select Save.

Enabling CORS

You must enable CORS for the origin https://api.fotoware.com. Here's how:

  1.  Install Microsoft's IIS CORS module from https://www.iis.net/downloads/microsoft/iis-cors-module.
  2. Find the web.config file of the IIS website on which your FotoWeb site is hosted.

DO NOT modify the web.config file in the Documents folder of the FotoWeb site! Your changes will be overwritten with every update. Instead, the web.config file of the website is free for you to customize. You can find its location by right-clicking on the website in IIS Manager and selecting Explore. For example, for Default Web Site, the location of the configuration file is typically C:\inetpub\wwwroot\web.config. If you create additional web sites, then each will have its own configuration file in a separate location that you choose, and you can and need to configure CORS separately for each site.

  1.  Add the following XML block under the <system.webServer> XML tag:
<cors enabled="true">
 <add origin="https://your-application.net" maxAge="120">
 <allowMethods>
 <add method="*"/>
 </allowMethods>
 <allowHeaders>
 <add header="*"/>
 </allowHeaders>
 </add>
</cors>

 This enables CORS from the given domain (in this case, https://your-application.net).

For more detailed configuration options, see the IIS CORS module official documentation (external link). Not all configurations will work with the FotoWeb API; only configurations documented here have been tested. If you think your configuration should work but doesn't, and it is required (due to a security policy required by your IT team, for example), contact Fotoware for support.

After registering the application and enabling CORS

Having registered the application on your Fotoware site and made the necessary CORS adjustments, authorize the Fotoware API:

  1. Go to https://api.fotoware.com
  2. Add your Fotoware site URL to the Site field at the top of the screen and select Authorize:
  3. Select Authorize again and log in to your site with a username and password (OAuth):
  4. When the authorization is complete, close the dialog box in the Swagger interface and explore the API!
swagger integration api exploration

Was this article helpful?

Yes
No
Give feedback about this article

Related Articles

  • Replacing lo-res images with hi-res in PDF workflows
  • Using database lookup to populate metadata fields with photographer information
  • Transferring assets that have been used in production into a long-term archive
  • Uploading assets using the API
eco-lighthouse-miljøfyrtårn

Company

  • About us
  • Resellers
  • Careers
  • Contact us

Help & support

  • Support center
  • Consultancy
  • Tech partners
  • Fotostation
  • System status

Trust Center

  • Legal
  • Security
  • Sustainability & ESG

Locations

Fotoware AS (HQ)
Tollbugata 35
0157 OSLO
Norway
FotoWare Switzerland AG
Industriestrasse 25
5033 Buchs (AG)
Switzerland

Copyright 2025 Fotoware All rights reserved.

  • Terms of service
  • Privacy policy
  • Cookie policy

Knowledge Base Software powered by Helpjuice

Expand