> ## Documentation Index
> Fetch the complete documentation index at: https://docs.langdock.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Tool-Parameter und Rückgabewerte exportieren

> Hole Tool-Parameter und Rückgabewerte über die Konversations-Exporte der Compliance API.

Konversations-Exporte enthalten die Argumente eines Tools und den Wert, den es zurückgegeben hat, wenn du `include_message_content=true` und `include_action_results=true` setzt.

## Endpunkte

Schick beide Parameter an einen dieser Requests:

```
GET /api/compliance/{workspace_id}/conversations
GET /api/compliance/{workspace_id}/conversations/{conversation_id}
GET /api/compliance/{workspace_id}/agents/{agent_id}/conversations
```

Listenantworten enthalten `next_cursor`. Gib diesen Wert als `cursor` mit, um die nächste Seite zu lesen. `limit` ist standardmäßig 50 und maximal 50.

`GET /api/compliance/{workspace_id}/messages` liefert Nutzungs- und Kostenzeilen. Tool-Parameter und Rückgabewerte stehen in den Konversations-Endpunkten oben.

## Basis-URL

```
https://app.langdock.com/api/compliance/{workspace_id}/conversations/{conversation_id}?include_message_content=true&include_action_results=true
```

> [!WARNING]
>
> **Dedicated Deployments**
>
> Ersetze `app.langdock.com` durch die URL deines Deployments. Der Pfad bleibt `/api/compliance/...`.

## Bevor du startest

* Erstelle einen API-Key mit dem Scope **Compliance API** unter [Einstellungen > API](https://app.langdock.com/settings/workspace/products/api).
* Schick den Key als `Authorization: Bearer YOUR_API_KEY`.

> [!NOTE]
>
> In der Cloud antworten diese Requests mit 404, bis die Compliance API für deinen Workspace eingeschaltet ist. Solange sie aus ist, siehst du den Scope **Compliance API** beim Erstellen eines Keys nicht. Dedicated Deployments liefern die API, solange das Deployment sie nicht abschaltet.

## Parameter

Gib `true` oder `false` als Strings mit. Jeder andere Wert liefert 400.

| Parameter | Pflicht | Beschreibung |
| - | - | - |
| `include_message_content` | Nein | `true` ergänzt jede Konversation um ein `messages`-Array. Der Standard ist `false`. Dann fehlt `messages`. |
| `include_action_results` | Nein | `true` ergänzt Action-Felder an Tool-Nachrichten. Das gilt nur zusammen mit `include_message_content=true`. Der Standard ist `false`. |

Mit nur `include_message_content=true` sind Tool-Nachrichten trotzdem dabei. `content` ist der Action-Name. `action_name`, `action_input`, `action_output` und `is_error` fehlen.

Mit nur `include_action_results=true` fehlt `messages` in der Antwort.

## Tool-Felder

Wenn beide Parameter `true` sind, enthält eine Tool-Nachricht:

| Feld | Beschreibung |
| - | - |
| `message_id` | ID der Chat-Nachricht |
| `role` | `tool` |
| `content` | Action-Name |
| `action_name` | Action-Name |
| `action_input` | Argumente, die an die Action übergeben wurden |
| `action_output` | Wert, den die Action zurückgegeben hat. Bei einem Fehler ist das die Fehler-Payload. |
| `is_error` | `true`, wenn die Action fehlgeschlagen ist, sonst `false` |
| `created_at` | Zeitpunkt der Nachricht |

Nachrichten mit der Rolle `user` oder `assistant` enthalten `message_id`, `role`, `content` und `created_at`.

## Beispiel

```bash theme={null}
curl "https://app.langdock.com/api/compliance/550e8400-e29b-41d4-a716-446655440000/conversations/550e8400-e29b-41d4-a716-446655440001?include_message_content=true&include_action_results=true" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

```json theme={null}
{
  "data": [
    {
      "conversation_id": "550e8400-e29b-41d4-a716-446655440001",
      "created_at": "2026-01-01T09:00:00.000Z",
      "updated_at": "2026-01-01T10:00:02.000Z",
      "workspace_name": "Acme",
      "created_by_id": "550e8400-e29b-41d4-a716-446655440002",
      "using_agent": true,
      "agent_id": "550e8400-e29b-41d4-a716-446655440003",
      "agent_name": "Sales assistant",
      "current_model": null,
      "num_messages": 2,
      "messages": [
        {
          "message_id": "550e8400-e29b-41d4-a716-446655440004",
          "role": "user",
          "content": "Look up open deals",
          "created_at": "2026-01-01T10:00:00.000Z"
        },
        {
          "message_id": "550e8400-e29b-41d4-a716-446655440005",
          "role": "tool",
          "content": "List_deals",
          "action_name": "List_deals",
          "action_input": { "status": "open" },
          "action_output": { "deals": [{ "id": "d-1", "name": "Acme" }] },
          "is_error": false,
          "created_at": "2026-01-01T10:00:02.000Z"
        }
      ]
    }
  ],
  "next_cursor": null
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.