Back to Documentation

Postman Collection

Download our Postman collection to quickly test the Citadelis API.

Citadelis API Collection

Ready-to-use Postman collection with all endpoints

Setup Instructions

1

Import the Collection

Open Postman and click Import. Select the downloaded JSON file or paste the copied JSON.

2

Configure Your API Key

Click on the collection name, go to the Variables tab, and update api_key with your actual API key.

api_key: citadel_sk_your_actual_key_here
3

Start Testing

Browse the collection folders, select a request, and click Send to test.

Whats Included

Models

  • List all available models

Chat Completions

  • Basic chat completion
  • Chat with anonymization enabled
  • Streaming chat completion

Anonymization

  • Simple text anonymization
  • Anonymize and process with LLM
  • Restore (deanonymize) text

Environment Variables

VariableDefault ValueDescription
base_urlhttps://citadelis.eu/api/v1API base URL
api_keycitadel_sk_your_key_hereYour API key (replace this!)

Collection JSON

{
  "info": {
    "name": "Citadelis API",
    "description": "OpenAI-compatible API with privacy-preserving anonymization",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "auth": {
    "type": "bearer",
    "bearer": [
      {
        "key": "token",
        "value": "{{api_key}}",
        "type": "string"
      }
    ]
  },
  "variable": [
    {
      "key": "base_url",
      "value": "https://citadelis.eu/api/v1",
      "type": "string"
    },
    {
      "key": "api_key",
      "value": "citadel_sk_your_key_here",
      "type": "string"
    }
  ],
  "item": [
    {
      "name": "Models",
      "item": [
        {
          "name": "List Models",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/models",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "models"
              ]
            },
            "description": "Lists all available AI models"
          }
        }
      ]
    },
    {
      "name": "Chat Completions",
      "item": [
        {
          "name": "Create Chat Completion",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"model\": \"Meta-Llama-3_3-70B-Instruct\",\n  \"messages\": [\n    {\n      \"role\": \"system\",\n      \"content\": \"You are a helpful assistant.\"\n    },\n    {\n      \"role\": \"user\",\n      \"content\": \"Hello!\"\n    }\n  ],\n  \"temperature\": 0.7\n}"
            },
            "url": {
              "raw": "{{base_url}}/chat/completions",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "chat",
                "completions"
              ]
            },
            "description": "Creates a chat completion"
          }
        },
        {
          "name": "Chat Completion with Anonymization",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"model\": \"Meta-Llama-3_3-70B-Instruct\",\n  \"messages\": [\n    {\n      \"role\": \"user\",\n      \"content\": \"Write an email to john@example.com about the meeting\"\n    }\n  ],\n  \"anonymize\": true\n}"
            },
            "url": {
              "raw": "{{base_url}}/chat/completions",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "chat",
                "completions"
              ]
            },
            "description": "Chat completion with PII anonymization enabled"
          }
        },
        {
          "name": "Streaming Chat Completion",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"model\": \"Meta-Llama-3_3-70B-Instruct\",\n  \"messages\": [\n    {\n      \"role\": \"user\",\n      \"content\": \"Tell me a short story\"\n    }\n  ],\n  \"stream\": true\n}"
            },
            "url": {
              "raw": "{{base_url}}/chat/completions",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "chat",
                "completions"
              ]
            },
            "description": "Streaming chat completion (SSE)"
          }
        }
      ]
    },
    {
      "name": "Anonymization",
      "item": [
        {
          "name": "Anonymize Text",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"text\": \"Contact me at john@example.com or call +33 6 12 34 56 78\"\n}"
            },
            "url": {
              "raw": "{{base_url}}/anonymize",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "anonymize"
              ]
            },
            "description": "Anonymizes PII in text"
          }
        },
        {
          "name": "Anonymize and Process with LLM",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"text\": \"Draft an email to john@example.com about the project deadline\",\n  \"process_with_llm\": true,\n  \"model\": \"Meta-Llama-3_3-70B-Instruct\"\n}"
            },
            "url": {
              "raw": "{{base_url}}/anonymize",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "anonymize"
              ]
            },
            "description": "Anonymizes text and processes with LLM"
          }
        },
        {
          "name": "Restore (Deanonymize)",
          "request": {
            "method": "PUT",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"text\": \"Hello {{NAME_1}}, your email is {{EMAIL_1}}\",\n  \"mapping\": {\n    \"{{NAME_1}}\": \"John Doe\",\n    \"{{EMAIL_1}}\": \"john@example.com\"\n  }\n}"
            },
            "url": {
              "raw": "{{base_url}}/anonymize",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "anonymize"
              ]
            },
            "description": "Restores anonymized text to original values"
          }
        }
      ]
    }
  ]
}

Alternative Tools

The Citadelis API works with any HTTP client or OpenAI-compatible SDK: