API Endpoints

Documentation for the REST API endpoints

All REST API endpoints are available under the prefix /api/rest/ and require a valid Bearer token for authentication. You can create API tokens in the Neleto admin under Profile Settings -> Security -> Create Token.

Authorization: Bearer <your-token>

For AI-agent access via Model Context Protocol, see MCP instead.

Pages

Method	Path	Description
`GET`	`/api/rest/pages`	List all pages
`POST`	`/api/rest/pages`	Create a page
`GET`	`/api/rest/pages/{id}`	Get a single page by ID
`PUT`	`/api/rest/pages/{id}`	Update a page
`DELETE`	`/api/rest/pages/{id}`	Soft-delete a page
`POST`	`/api/rest/pages/duplicate`	Duplicate a page
`GET`	`/api/rest/pages/search`	Search pages
`GET`	`/api/rest/pages/count`	Count pages
`GET`	`/api/rest/pages/blog-post-page`	Get the configured blog post page
`GET`	`/api/rest/pages/event-post-page`	Get the configured event post page

Layouts

Method	Path	Description
`GET`	`/api/rest/layouts`	List all layouts
`POST`	`/api/rest/layouts`	Create a layout
`GET`	`/api/rest/layouts/{id}`	Get a single layout by ID
`PUT`	`/api/rest/layouts/{id}`	Update a layout
`DELETE`	`/api/rest/layouts/{id}`	Soft-delete a layout
`GET`	`/api/rest/layouts/search`	Search layouts
`GET`	`/api/rest/layouts/count`	Count layouts

Components

Method	Path	Description
`GET`	`/api/rest/components`	List all components
`POST`	`/api/rest/components`	Create a component
`GET`	`/api/rest/components/{id}`	Get a single component by ID
`PUT`	`/api/rest/components/{id}`	Update a component
`DELETE`	`/api/rest/components/{id}`	Delete a component
`GET`	`/api/rest/components/{id}/export`	Export a component
`GET`	`/api/rest/components/{id}/elements`	List elements using this component
`POST`	`/api/rest/components/import`	Import components
`GET`	`/api/rest/components/search`	Search components
`GET`	`/api/rest/components/count`	Count components

Blog Posts

Method	Path	Description
`GET`	`/api/rest/posts`	List all blog posts
`POST`	`/api/rest/posts`	Create a blog post
`GET`	`/api/rest/posts/{id}`	Get a single post by ID
`PUT`	`/api/rest/posts/{id}`	Update a post
`DELETE`	`/api/rest/posts/{id}`	Delete a post
`GET`	`/api/rest/posts/search`	Search posts
`POST`	`/api/rest/posts/import`	Import posts from WordPress XML
`GET`	`/api/rest/posts/count`	Count posts

Events

Method	Path	Description
`GET`	`/api/rest/events`	List all events
`POST`	`/api/rest/events`	Create an event
`GET`	`/api/rest/events/{id}`	Get a single event by ID
`PUT`	`/api/rest/events/{id}`	Update an event
`DELETE`	`/api/rest/events/{id}`	Delete an event
`GET`	`/api/rest/events/search`	Search events
`GET`	`/api/rest/events/today`	List events happening today
`GET`	`/api/rest/events/upcoming`	List upcoming events
`GET`	`/api/rest/events/count`	Count events

Files

Method	Path	Description
`GET`	`/api/rest/files`	List files / load file by path or IDs
`POST`	`/api/rest/files`	Create a file, folder, or remote file entry
`GET`	`/api/rest/files/{id}`	Get a file by UUID
`PUT`	`/api/rest/files/{id}`	Update file metadata or content
`GET`	`/api/rest/files/search`	Search files
`POST`	`/api/rest/files/move`	Move or copy files

Redirects

Method	Path	Description
`GET`	`/api/rest/redirects`	List all redirects
`POST`	`/api/rest/redirects`	Create a redirect
`GET`	`/api/rest/redirects/{id}`	Get a redirect by ID
`PUT`	`/api/rest/redirects/{id}`	Update a redirect
`DELETE`	`/api/rest/redirects/{id}`	Delete a redirect

Settings

Method	Path	Description
`GET`	`/api/rest/settings`	Get CMS settings
`PUT`	`/api/rest/settings`	Update CMS settings

Users

Method	Path	Description
`GET`	`/api/rest/users`	List users
`POST`	`/api/rest/users`	Create a user
`GET`	`/api/rest/users/{id}`	Get a user by ID
`PUT`	`/api/rest/users/{id}`	Update a user
`DELETE`	`/api/rest/users/{id}`	Delete a user
`GET`	`/api/rest/users/search`	Search users
`PUT`	`/api/rest/users/me`	Update the current user

API Tokens

Method	Path	Description
`GET`	`/api/rest/tokens`	List API tokens
`POST`	`/api/rest/tokens`	Create an API token
`DELETE`	`/api/rest/tokens/{id}`	Delete an API token

Images

See Image Scaling for the image transformation endpoint available at /images/user-upload/{id}.