Create an author

import app from '@adonisjs/core/services/app'
import { SiteClient } from '@fetchski/attract-cms-sdk'

const site = await app.container.make(SiteClient)
const author = await site.authors().createAuthor({ title: 'Example title' })

{
  "title": "Example title",
  "bio": "Example bio",
  "_user": [
    {}
  ],
  "showOnSite": true,
  "showPhoto": true,
  "slug": "example-slug",
  "visibility": "public",
  "scheduledPublish": "Example scheduled publish",
  "scheduledUnpublish": "Example scheduled unpublish",
  "archived": false,
  "_id": "clx8m2k4p0000a1b2c3d4e5f6",
  "type": "Example type",
  "createdAt": "2026-10-24T09:30:00.000Z",
  "updatedAt": "2026-10-24T09:30:00.000Z",
  "aposShareKey": "k3v9x2m7q1z8w4p6"
}

In your app

import { inject } from '@adonisjs/core'
import { SiteClient } from '@fetchski/attract-cms-sdk'

@inject()
export default class CreateAuthorController {
  constructor(protected site: SiteClient) {}

  async handle() {
    return this.site.authors().createAuthor({ title: 'Example title' })
  }
}

import router from '@adonisjs/core/services/router'

const CreateAuthorController = () => import('#controllers/create_author_controller')

router.post('/author', [CreateAuthorController])

Behavior

• Access: an API key with content:authors:write (or a master above it: content:authors:all, content:all, admin:all). In published mode (the default) it goes live too, so the key also needs content:authors:publish (or a master above it); send aposMode=draft to change only the draft. A signed-in person may call it as far as their own permissions allow; anyone else gets 403.
• Rate limit: the key’s own writes-per-minute limit, set when the key is created (default 120); over it, 429 with Retry-After. The client waits and retries for you; you see RateLimited only if that runs out.
• Retries: a write is sent again only after a 429 (refused before it acted) or when it never reached the site. After a timeout or a 5xx it may have landed: check before you send it again.
• Timeout: 15 s per attempt by default; raise timeout (milliseconds) in config/attract.ts for longer.

Test it

import { test } from '@japa/runner'
import app from '@adonisjs/core/services/app'
import { fakeAttract } from '@fetchski/attract-cms-adonis/testing'
import CreateAuthorController from '#controllers/create_author_controller'

test('authors.createAuthor', async () => {
  const site = fakeAttract()

  const controller = await app.container.make(CreateAuthorController)
  await controller.handle()

  site.assertCalled('authors.createAuthor')
})

node ace test

import { test } from '@japa/runner'
import { factories, fakeAttract } from '@fetchski/attract-cms-adonis/testing'

test('authors.createAuthor answers your values', async ({ assert }) => {
  const site = fakeAttract({
    'authors.createAuthor': factories.Author({ title: 'Your value' }),
  })

  const author = await site.authors().createAuthor({ title: 'Example title' })
  assert.containSubset(author, { title: 'Your value' })
})

Related