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

# Drafts and locales

> Every document has a published copy and a draft, in each locale.

Editors change a document's **draft**, then publish it. Until they do, visitors and the API see the
**published** copy as it was.

```mermaid theme={"dark"}
flowchart LR
    A[Editor saves] --> B[Draft]
    B -- Publish --> C[Published]
    C -- seen by --> D[Visitors and API keys]
    B -. Discard draft changes .-> C
```

## Published or draft

**aposMode** `string` (default: published)

`published` answers what visitors see. `draft` answers the latest edits, published or not: it needs
a credential that may see drafts, such as an API key with the type's write scope
(`content:<type>:write`). The public, and a key with only the read scope, get `403`.

## Locales

**aposLocale** `string`

The locale to read or write (`en`, `fr` …). Left out, it is the site's default locale.

A document's locales are listed by its **List locales** route, under **Publishing** in the API
reference.

## Ids

A document's id names its locale and mode.

```text Published theme={"dark"}
ckq3v8x5b0001:en:published
```

```text Draft theme={"dark"}
ckq3v8x5b0001:en:draft
```

> [!TIP]
>
> The same document's draft id is its published id with the last part changed. A create answers the id
> of the mode it was made in.


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