Endpoint Reference

Every site-management endpoint, grouped by resource, with examples.

Every endpoint below is scoped to one site, and the site is named by its domain in the URL path. Replace mysite.e9sites.com with your own domain, and put your token in an environment variable called ENINE_TOKEN.

Two groups are deliberately not documented here because they are not part of site management: /api/chat/ drives the built-in chat builder, and /api/contact/ receives submissions from your own site's contact form.

Content

Every category, section, and content item on your site is an artifact. Categories are roots; items are their children.

Mapping

A map is a cross-reference between two items -- a project and the service it used, an article and the person who wrote it. Each one appears on the other's page.

Media

Uploading is multipart/form-data on the field file, up to 10 MB per file. You can send several in one call.

SEO and AEO

A duplicate canonical returns 409.

Sites

You get 201 on success and 409 if the domain is already taken.

Tags

Tags belong to the site; assignments belong to artifacts. Create the tag once, then assign it wherever it applies.

Transfer

These are the API equivalents of the Export menu in the manager, which makes them the simplest way to back up a site on a schedule.

Links

There is no writable url field on an artifact. Every outbound destination -- a link on a card, a social profile, a phone number, an email -- is a catalogue entry that artifacts and the site config point at.

Team

Roles are reader, editor, and admin, and both username and role are required when adding someone.