API Reference

Base URL: https://twixb.com/api/v1 All requests require the X-API-Key header. See Authentication for details.

Endpoints

Newsfeeds

Method	Endpoint	Description
GET	`/v1/newsfeeds`	List newsfeeds
POST	`/v1/newsfeeds`	Create newsfeed
GET	`/v1/newsfeeds/{id}`	Get newsfeed
PUT	`/v1/newsfeeds/{id}`	Update newsfeed
DELETE	`/v1/newsfeeds/{id}`	Delete newsfeed

Sources

Method	Endpoint	Description
GET	`/v1/sources/{newsfeed_id}`	List sources
POST	`/v1/sources/{newsfeed_id}`	Add source
POST	`/v1/sources/validate`	Validate source URL
DELETE	`/v1/sources/{source_id}`	Delete source

Posts

Method	Endpoint	Description
GET	`/v1/posts/newsfeed/{newsfeed_id}`	List posts
GET	`/v1/posts/{post_id}`	Get post
PUT	`/v1/posts/{post_id}/read`	Mark read
PUT	`/v1/posts/{post_id}/unread`	Mark unread
PUT	`/v1/posts/{post_id}/hide`	Hide post

Lists

Method	Endpoint	Description
GET	`/v1/lists`	List all lists
POST	`/v1/lists`	Create list
GET	`/v1/lists/{list_id}`	Get list
POST	`/v1/lists/{list_id}/items`	Add to list
DELETE	`/v1/lists/{list_id}/items/{post_id}`	Remove from list