API resource

Smarty (brand memory)

Smarty is the brand agent: one memory of the brand that the other agents read (comment and DM replies, Agent Posts copy). The brain holds the pitch, story, offers (with links and DM keywords), audiences (pains, wants, objections, words), voice (tone, use, avoid, examples), pillars, topics to avoid, competitors, FAQs, rules and routing. Any active plan.

Read the brand memory

GET/v1/smarty

The brain, its status (learning, ready or failed), the sources it read and setupAt.

curl "https://creatoros-production-5658.up.railway.app/v1/smarty" \
  -H "Authorization: Bearer $CREATOROS_API_KEY"
Response 200
{
  "smarty": {
    "status": "ready",
    "brain": {
      "pitch": "Short-form video coaching for dentists",
      "offers": [
        {
          "name": "Patient Magnet course",
          "url": "https://example.com/course",
          "keyword": "PATIENTS"
        }
      ]
    }
  }
}

Save the brand memory

PUT/v1/smarty

Replaces the brain: read it, edit it, send the whole object back (fields left out are emptied).

Body

brainobjectrequired

The full brain from GET /v1/smarty, edited.

curl -X PUT "https://creatoros-production-5658.up.railway.app/v1/smarty" \
  -H "Authorization: Bearer $CREATOROS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "brain": {
      "pitch": "Short-form video coaching for dentists",
      "rules": [
        "Never promise a number of new patients"
      ]
    }
  }'
Response 200
{
  "smarty": {
    "status": "ready"
  }
}

Learn from a website, links or notes

POST/v1/smarty/learn

Smarty reads them and merges what it learns into the brain (it only adds; nothing already written is replaced). Notes alone finish in seconds; a website takes a few minutes. Poll GET /v1/smarty. An empty body re-reads every saved source. 409 already_learning.

Body

websitestring

The brand's website.

urlsstring[]

Other links to read (up to 8).

notesstring

Notes in the owner's words.

curl -X POST "https://creatoros-production-5658.up.railway.app/v1/smarty/learn" \
  -H "Authorization: Bearer $CREATOROS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "website": "https://example.com",
    "notes": "We sell a course to dentists. Friendly, no hype."
  }'
Response 202
{
  "smarty": {
    "status": "learning"
  }
}

Brand photos

GET/v1/smarty/photos

The photo library (the creator, logos, products, places), each tagged automatically. POST /v1/smarty/photos with { photos: [{ url }] } (med_ ids or https URLs, up to 50) adds some; PATCH / DELETE /v1/smarty/photos/{photoId} edit or remove one. Agent Posts covers pick from it.

curl "https://creatoros-production-5658.up.railway.app/v1/smarty/photos" \
  -H "Authorization: Bearer $CREATOROS_API_KEY"
Response 200
{
  "photos": [
    {
      "id": "5e4d3c2b-1a0f-4e9d-8c7b-6a5f4e3d2c1b",
      "kind": "person",
      "url": "https://api.creatoros.ca/v1/media/med_..."
    }
  ]
}