Table of Contents
Configuring auto-tagging
Learn how to configure auto-tagging.
18. June 2026
Table of Contents
Auto-tagging can be configured as an action with an Execute webhook source or as an asset ingested webhook. Both use the same URL format to call auto-tagging, and configuration settings are provided as part of the URL in both cases. The webhook URL requires an autotag ID and secret, which Fotoware will provide.
The system administrator can set the minimum confidence level for returned tags, the field where auto-tagging results are stored, and the integration details for the webhook URL, making it fast and easy to maintain. You can experiment with the confidence setting to potentially return more accurate results.
Example URL:
https://fw-shared-mgt-api-apim.azure-api.net/integration/api/assets/analysis?version=4&confidence=0.6&showConfidence=true&languages=en,de,nb&features=Tags:en=820,nb=25|Brands:all=829|Faces:all=816|Text:all=850|Description:en=817&autoTagId=clkjh2c8-b2e1-45c3-3159-08db9f189b36&autoTagSecret=ZZV0nC55XXMBMv51ij9o2MwToi0ZVgQKIx1UWi2ldduZMSWLP4I28ely7g2hgkj5gCiYcw23Gj2qov5M55hSNA~~
Note
Auto-tagging overwrites any content in metadata fields, so make sure to choose fields that are used only for auto-tagging.
| URL parameter | Description |
|---|---|
autoTagId |
A unique customer identifier for authentication. This is generated by Fotoware and is always the same for each customer integration. Mandatory field. Example: |
autoTagSecret |
This parameter pairs with autoTagId for authentication. Example: autoTagSecret=BKWseamUlCyInNbTzDIXENOdCpTVVlelnFxo72CeTfIpuDGTeQFnei5Eg06yB4l2-43ZVyy3L-DbSIINHiUayA~~
|
confidence |
The level of accuracy for the returned results. The processing will only return tags with a confidence level greater than or equal to the specified value. Example: |
showConfidence |
Include or exclude the confidence value in the tag texts. Boolean (true/false) Example: showConfidence=true
|
genderNeutralCaption |
OPTIONAL Captions do not contain gender terms ("man", "woman", "boy", and "girl") by default; these terms are replaced with “person” to obtain gender-neutral captions. Without this parameter, the default value is Example: |
languages |
A comma-separated list of languages. Tags and other features will be returned in all selected languages. Example: languages=en,de,nb
|
features |
Lists the auto-tagging features that the customer wants to use and maps the results to a metadata field in Fotoware. Use the allassigner (as in the example below) to add data for all languages defined in languages into the same field.Example: features=Tags:all=820|Description:all=200|Brands:all=829|Faces:all=880|Text:all=850You can define each field separately to separate different languages into different fields in the metadata. In the following example, tags and descriptions are separated into different metadata fields for English and Norwegian. Brands and text are not translated, so you use the all keyword for these.Example: features=Tags:en=820,nb=26|Description:en=200,nb=121|Brands:all=829|Faces:all=880|Text:all=850
|
version |
By default, the webhook targets version 4. Example: version=4
|