---
title: "Create Tools Service Execution Log Route"
method: POST
path: "/backoffice/tools-service/execution-logs"
tags: ["Backoffice"]
---

# Create Tools Service Execution Log Route

`POST /backoffice/tools-service/execution-logs`

Store a tools service execution log.

## Request body

- CreateToolsServiceExecutionLog — Create tools service execution log request.
  - `user_id` string, nullable
  - `tool_name` string, required
  - `provider_name` string, nullable
  - `toolhouse_id` string, nullable
  - `toolhouse_id_namespace` string, nullable
  - `raw_toolhouse_id` string, nullable
  - `request_id` string, nullable
  - `source` string, required
  - `status` 'success' | 'error', required
  - `started_at` string, date-time, required
  - `finished_at` string, date-time, required
  - `duration_ms` integer, required
  - `credits_used` integer
  - `input` object
  - `output` object, nullable
  - `error` string, nullable
  - `credit_reservation_id` integer, nullable

## Response `200`

Tools service execution log stored successfully

- ToolsServiceExecutionLog — Tools service execution log row.
  - `user_id` string, nullable
  - `tool_name` string, required
  - `provider_name` string, nullable
  - `toolhouse_id` string, nullable
  - `toolhouse_id_namespace` string, nullable
  - `raw_toolhouse_id` string, nullable
  - `request_id` string, nullable
  - `source` string, required
  - `status` 'success' | 'error', required
  - `started_at` string, date-time, required
  - `finished_at` string, date-time, required
  - `duration_ms` integer, required
  - `credits_used` integer
  - `input` object
  - `output` object, nullable
  - `error` string, nullable
  - `credit_reservation_id` integer, nullable
  - `id` integer, required
  - `created_at` string, date-time, required

## Other responses

- `409` — Conflicting execution log
- `422` — Invalid execution log reference
- `503` — Execution log storage is temporarily unavailable

## Changes

- **2026-09-04** `fc441a13cd1f` — 1 breaking, 3 info
  - removed the media type `application/json` for the response with the status `422`
  - added the non-success response with the status `409`
  - added the non-success response with the status `503`
  - removed the non-success response with the status `500`

[Change history](https://skmtc.dev/toolhouse/apis/toolhouse-api/changes/backoffice/tools-service/execution-logs/post.md)

---

[API](https://skmtc.dev/toolhouse/apis/toolhouse-api.md) · [All operations](https://skmtc.dev/toolhouse/apis/toolhouse-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/toolhouse/toolhouse-api/revisions/fc441a13cd1f/schema)