How can I add topics via API?

The 404 Forbidden was because for those API calls to be allowed, I need to set a per site feature flag. — Now done.

However, please wait a bit with those API requests?

I think the endpoint you want to use, is in fact /-/v0/upsert (which should probably get renamed to /-/v0/import). I'll reply here later today or tomorrow, with info about the JSON format.

/-/v0/upsert-simple was intended for creating new pages, and generating notifications about those new pages. But the pages you're inserting, aren't new. In addition to that, /-/v0/upsert-simple is now a bit deprecated, and instead there's a new Do API at /-/do, via which one can send a bunch of things-to-do, e.g. create new pages and replies, and then Talkyard will do it and generate notifications and (once implemented) webhook events. Whilst /-/upsert won't generate notifications or events; it just silently upserts stuff.

Hi @ana now I've created an automated test that shows, in code, how one can import topics, and shows the JSON format.

Here's the JSON format: https://github.com/debiki/talkyard/blob/463dc6017107704d196ac590c1e9d6aa238cb1bb/tests/e2e-wdio7/specs/dir.create-site-imp-json.2br.e2e.ts#L318

Id numbers for things that are getting imported, should start at 2000000001 (or -2000000001 for guests users, which have negative ids — no real accounts).
And if the extId (external id, e.g. unique Reddit reply id) matches something already in the database, Talkyard updates it. Otherwise, creates it.

You need to assign an external ID to a category too, where the imported topics get placed. Here's the category, in the JSON: (at the bottom of the file)
https://github.com/debiki/talkyard/blob/463dc6017107704d196ac590c1e9d6aa238cb1bb/tests/e2e-wdio7/specs/dir.create-site-imp-json.2br.e2e.ts#L645

And here's how you can post the JSON to Talkyard — namely via a to-talkyard help script:
https://github.com/debiki/talkyard/blob/463dc6017107704d196ac590c1e9d6aa238cb1bb/tests/e2e-wdio7/utils/utils.ts#L65

Here's how you'd invoke it: (from the Git repo root)

nodejs to-talkyard/dist/to-talkyard/src/to-talkyard.js  \
        --talkyardJsonPatchFile=JSON_FILE  \
        --sysbotApiSecret=SECRET  \
        --sendTo=TALKYARD_SITE_ORIGIN

But first you'd need to run yarn build in to-talkyard/, so that the to-talkyard/dist/ folder gets generated.

***

I'm thinking the above isn't so user friendly. I'll write more nice looking docs during the weekend. (Sorry things "always" take a bit long)

Hi again @ana, now I wrote docs about the JSON import file structure: How to Import Discussions to Talkyard

It's more (longer) docs than what I had thought, and maybe annoyingly many small things to think about. I wonder if in the end it might actually be quicker to copy-paste pages from Reddit instead.