---
title: "List blog authors"
method: GET
path: "/blog/authors"
tags: ["Blog authors"]
---

# List blog authors

`GET /blog/authors`

## Request

- Base URL: `https://api.cavuno.com/v1`
- URL: `https://api.cavuno.com/v1/blog/authors`
- Auth: HTTP bearer

Returns a list of your blog authors. The authors are returned sorted by update date, with the most recently updated authors appearing first.

## Query parameters

- `cursor` string: An opaque pagination cursor returned in the `nextCursor` field of a previous response. Pass it back to fetch the next page of results.
- `limit` integer: A limit on the number of objects to be returned. Limit can range between 1 and 100.

## Response `200`

Successful response.

- object
  - `object` 'list', required
  - `url` string, required
  - `hasMore` boolean, required
  - `nextCursor` string, nullable, required
  - `data` BlogAuthor[], required
    - `id` string, required: Unique identifier for the object. Use this value as the `{id}` path parameter for the author endpoints (e.g. `GET /v1/blog/authors/{id}`).
    - `object` 'blog_author', required: String representing the object's type. Objects of the same type share the same value.
    - `name` string, required: Display name of the author.
    - `slug` string, required: URL-friendly slug for the author.
    - `bio` string, nullable, required: Short biography, or `null` if not set.
    - `email` string, nullable, required: The author's email address, or `null` if not set.
    - `location` string, nullable, required: The author's free-text location label, or `null` if not set.
    - `status` string, nullable, required: Author visibility status, or `null` if not set.
    - `avatarUrl` string, nullable, required: URL of the author avatar, or `null` if no avatar is set.
    - `websiteUrl` string, nullable, required: The author's website URL, or `null` if not set.
    - `facebookUrl` string, nullable, required: The author's Facebook URL, or `null` if not set.
    - `twitterUrl` string, nullable, required: The author's X (Twitter) URL, or `null` if not set.
    - `linkedinUrl` string, nullable, required: The author's LinkedIn URL, or `null` if not set.
    - `githubUrl` string, nullable, required: The author's GitHub URL, or `null` if not set.
    - `metaTitle` string, nullable, required: SEO meta title, or `null` if not set.
    - `metaDescription` string, nullable, required: SEO meta description, or `null` if not set.
    - `createdAt` string, required: Time at which the author was created. ISO 8601 datetime.
    - `updatedAt` string, nullable, required: Time at which the author was last updated, or `null` if it has never been updated. ISO 8601 datetime.

## Other responses

- `400`: The request was malformed.

## Changes

- **2026-10-19** `c34152c38176`: 1 info
  - added the optional property `error/upgrade` to the response with the `400` status

[Operation history](https://skmtc.dev/cavuno/apis/cavuno-v1-rest-api/changes/blog/authors/get.md)

---

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