Sign in

v1

latestOpenAPI 3.1.02026-07-13305453.8 KB
Authors

Create author

Create a new author. Requires a private API key. Plan limits apply.

post/v1/authors

Request body

namestring required
slugstring required
biostring nullable
rolestring nullable
emailstring email nullable
imagestring uri nullable

Example request

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

Response

Author created 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"
      }
    ]
  }
}