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

# Authors

> List and create blog article authors to attribute blog posts

Authors are the bylines shown on blog posts. Create an author, then pass its `id` as `author_id` when you [create a blog post](/docs/api-reference/content/pages).

<Info>
  Authenticate with your API key in the `x-api-key` header.
</Info>

## List authors

```http theme={null}
GET https://api.kardow.com/authors
```

```bash cURL theme={null}
curl --url "https://api.kardow.com/authors" \
  --header "x-api-key: your-api-key-here"
```

```json theme={null}
{
  "data": [
    { "id": "3c4d...", "name": "Jane Doe", "avatar_url": "https://cdn.kardow.com/...", "created_at": "2026-07-01T00:00:00Z" }
  ]
}
```

## Create an author

```http theme={null}
POST https://api.kardow.com/authors
```

<ParamField body="name" type="string" required>Author display name.</ParamField>
<ParamField body="avatar_url" type="string">Optional avatar image URL. Host it with the [Assets API](/docs/api-reference/content/assets) for a stable link.</ParamField>

```bash cURL theme={null}
curl --request POST \
  --url "https://api.kardow.com/authors" \
  --header "Content-Type: application/json" \
  --header "x-api-key: your-api-key-here" \
  --data '{ "name": "Jane Doe" }'
```

Use the returned `id` as `author_id` on a blog post to attribute it.