Endpoint
POST https://requiems.xyz/v1/technology/format
Convert Format
Convert content from one structured data format to another. Supported formats: json, yaml, csv, xml, toml.
Parameters
| Name |
Type |
Required |
Location |
Description |
from |
string |
yes |
body |
Source format. One of: json, yaml, csv, xml, toml |
to |
string |
yes |
body |
Target format. One of: json, yaml, csv, xml, toml |
content |
string |
yes |
body |
The content to convert, serialized as a string in the source format. |
Request Example
{
"from": "json",
"to": "yaml",
"content": "{\"name\": \"Alice\", \"age\": 30}"
}
Response Example
{
"data": {
"result": "age: 30\nname: Alice\n"
},
"metadata": {
"timestamp": "2026-01-01T00:00:00Z"
}
}
Response Fields
| Field |
Type |
Description |
result |
string |
The converted content serialized in the target format. |
Errors
422 validation_failed — One of from, to, or content is missing, or from/to is not one of the supported format values.422 invalid_json — The content field is not valid JSON (when from is json).422 invalid_yaml — The content field is not valid YAML (when from is yaml).422 invalid_csv — The content field is not valid CSV, or a row has more columns than the header (when from is csv).422 invalid_xml — The content field is not valid XML (when from is xml).422 invalid_toml — The content field is not valid TOML (when from is toml).422 conversion_error — The data structure is incompatible with the target format (e.g. converting a JSON array to TOML, which requires a top-level object).413 content_too_large — The content field exceeds the 512 KB limit.
1---2name: data-format-conversion-post-format3description: Endpoint4---56## Endpoint78**POST https://requiems.xyz/v1/technology/format**910## Convert Format1112Convert content from one structured data format to another. Supported formats: json, yaml, csv, xml, toml.1314## Parameters1516| Name | Type | Required | Location | Description |17| ---- | ---- | -------- | -------- | ----------- |18| `from` | string | yes | body | Source format. One of: json, yaml, csv, xml, toml |19| `to` | string | yes | body | Target format. One of: json, yaml, csv, xml, toml |20| `content` | string | yes | body | The content to convert, serialized as a string in the source format. |2122## Request Example2324```json25{26 "from": "json",27 "to": "yaml",28 "content": "{\"name\": \"Alice\", \"age\": 30}"29}30```3132## Response Example3334```json35{36 "data": {37 "result": "age: 30\nname: Alice\n"38 },39 "metadata": {40 "timestamp": "2026-01-01T00:00:00Z"41 }42}43```4445## Response Fields4647| Field | Type | Description |48| ----- | ---- | ----------- |49| `result` | string | The converted content serialized in the target format. |5051## Errors5253- `422` **validation_failed** — One of from, to, or content is missing, or from/to is not one of the supported format values.54- `422` **invalid_json** — The content field is not valid JSON (when from is json).55- `422` **invalid_yaml** — The content field is not valid YAML (when from is yaml).56- `422` **invalid_csv** — The content field is not valid CSV, or a row has more columns than the header (when from is csv).57- `422` **invalid_xml** — The content field is not valid XML (when from is xml).58- `422` **invalid_toml** — The content field is not valid TOML (when from is toml).59- `422` **conversion_error** — The data structure is incompatible with the target format (e.g. converting a JSON array to TOML, which requires a top-level object).60- `413` **content_too_large** — The content field exceeds the 512 KB limit.
gabrielmoreira