---
title: "Convert a code-authored document to editable blocks"
method: POST
path: "/v1/spaces/{spaceId}/content/conversions"
tags: ["Spaces"]
---

# Convert a code-authored document to editable blocks

`POST /v1/spaces/{spaceId}/content/conversions`

## Request

- Base URL: `https://api.spacefast.com`
- URL: `https://api.spacefast.com/v1/spaces/{spaceId}/content/conversions`
- Auth: one of:
  - HTTP bearer
  - API key in cookie `__Host-better-auth.session_token`
  - OAuth 2 (authorization code, authorization URL `https://api.spacefast.com/v1/auth/oauth2/authorize`, token URL `https://api.spacefast.com/v1/auth/oauth2/token`; client credentials, token URL `https://api.spacefast.com/v1/auth/oauth2/token`, scopes: `spaces:write`)

Queues an explicit source ownership conversion. Preserves the original code in source history and publishes the editable document through the normal source commit and build pipeline. Reuse the operation ID when retrying the same conversion.

## Path parameters

- `spaceId` string, required

## Request body

- object
  - `postId` integer, required
  - `bindingId` string, required
  - `operationId` string, required

## Response `200`

Response for status 200

- object
  - `$schema` string, uri: Canonical JSON Schema URL for this response body. The server also sends it in the `Link: rel="describedby"` response header.
  - `data` object, required
    - `postId` integer, required
    - `bindingId` string, required
    - `operationId` string, required
    - `status` 'queued', required

## Other responses

- `default`: Problem details (RFC 9457). Any 4xx/5xx response is one `application/problem+json` document.

---

[API](https://skmtc.dev/spacefast/apis/spacefast-api.md) · [All operations](https://skmtc.dev/spacefast/apis/spacefast-api/llms.txt) · [OpenAPI document](https://skmtc.dev/spacefast/apis/spacefast-api/revisions/bd165bc7c983?raw)
