v1

latestOpenAPI 3.1.02026-07-13305453.8 KB

Authors

Update author

Update an existing author by ID or slug. Requires a private API key.

patch/v1/authors/{identifier}

Path parameters

identifierstring required

Author ID or slug

Example:john-doe

Author ID or slug

Request body

namestring

slugstring

biostring nullable

rolestring nullable

emailstring email nullable

imagestring uri nullable

Example request

{
  "name": "John Doe",
  "slug": "john-doe",
  "bio": "Updated bio",
  "role": "Senior Editor",
  "email": "john@example.com",
  "image": "https://media.marblecms.com/new-avatar.jpg",
  "socials": [
    {
      "platform": "x",
      "url": "https://x.com/johndoe"
    }
  ]
}

Response

Author updated successfully

Example response

{
  "author": {
    "id": "cryitfjp3456lm06xfpzcgl0",
    "name": "John Doe",
    "slug": "john-doe",
    "bio": "Technical writer and developer",
    "role": "Editor",
    "image": "https://media.marblecms.com/avatar.jpg",
    "socials": [
      {
        "url": "https://twitter.com/johndoe",
        "platform": "twitter"
      }
    ]
  }
}