Impersonate a user - Fluid Topics - Latest

As a USERS_ADMIN user, it is possible to impersonate another user's search or AI query by adding the FT-Impersonate-User-Id header parameter, and assigning it a userId as value in selected web services.

The value of the FT-Impersonate-User-Id header parameter must match a userId provided by the Search users web service. Impersonating another user can be useful to test access rules, for example.

Impersonation is possible in the following search web services:

• Clustered search
• Search documents
• Search maps
• Search topics
• Suggest
• Semantic search
• Clustered semantic search

Impersonation is also possible in the following AI-related web services:

• Retrieval-augmented generation (RAG)
• Agentic retrieval-augmented generation (RAG)
• Query a large language model (LLM)

Example

In the following example, a curl command uses the FT-Impersonate-User-Id header parameter:

curl --request POST 'https://docs.fluidtopics.com/api/khub/maps/search' \
--header 'Ft-Calling-App: antidot/doc' \
--header 'Ft-Calling-App-Version: master-48257' \
--header 'Authorization: Bearer kljJFLS45fdsar4asdrgKGjdfKJLSUON' \
--header 'Content-Type: application/json' \
--header 'FT-Impersonate-User-Id: 756e38ed-bbc2-447a-985c-f2c7cc50f4ef7' \
--data '{
  "query": "API"
}'

Using the FT-Impersonate-User-Id header parameter can return the following error codes: