Files
SnapOtter/apps/docs/tools/files/yaml-json.md
T
SnapOtterandGitHub f858c4cea0 feat: clearer, disambiguated tool names across all surfaces (#520)
Renames 18 ambiguous or hard-to-search tool names so image tools self-qualify like the other modalities ("Compress" becomes "Compress Image"), and cleans up a few awkward names. Propagated across search (constants.ts), display (en.ts + 20 locales), the OpenAPI base spec + 20 locale specs, and the docs tool-page headings in 21 languages. Removes the duplicate "Normalize Audio" summary shared by the video and audio endpoints. Tool ids and routes are unchanged, so no API paths or bookmarks break.
2026-07-15 21:55:51 +08:00

1.4 KiB

description
description
Convert between YAML and JSON, both directions.

Convert YAML / JSON

Convert between YAML and JSON formats in both directions. Upload a YAML file to get JSON, or upload a JSON file to get YAML.

API Endpoint

POST /api/v1/tools/files/yaml-json

Accepts multipart form data with a YAML or JSON file. No settings field is required.

Parameters

This tool has no configurable parameters. The conversion direction is determined by the input file extension.

Example Request

YAML to JSON:

curl -X POST http://localhost:1349/api/v1/tools/files/yaml-json \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@config.yaml"

JSON to YAML:

curl -X POST http://localhost:1349/api/v1/tools/files/yaml-json \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@config.json"

Example Response

{
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/config.json",
  "originalSize": 620,
  "processedSize": 780
}

Notes

  • Conversion direction is auto-detected from the input file extension: .yaml or .yml produces .json, and .json produces .yaml.
  • Both .yaml and .yml extensions are accepted.
  • Only the first document in a multi-document YAML file is converted; additional documents separated by --- are ignored.