Build on PluralSpace
We're building a full REST API with OAuth2 and API token authentication so you can create your own tools, integrations, and experiences on top of PluralSpace.
What we're building
The API will give you access to all the core features of PluralSpace.
Members
List, create, update, and delete system members. Access profiles, custom fields, groups, and relationships.
Fronts
Start and end fronts, list front history, and include member details with each entry.
Journal
Create and read journal entries programmatically. Full CRUD support.
Polls
Create polls, cast votes, and list system polls.
Thoughts
Read and set the thought of the day for your system's dashboard.
Groups & Fields
Manage member groups and custom field definitions and values.
Relationships
Read member relationships and relationship types within a system.
Wrapped
Access yearly and monthly wrapped snapshots and activity recaps.
OAuth2 from day one
The API will support both OAuth2 and personal API tokens for flexible, secure authentication. Third-party apps will use OAuth2, while your own scripts and tools will be able to use personal API tokens.
-
Authorization code grant · The standard OAuth2 flow for third-party applications that need to act on behalf of a user.
-
Token-based access · Personal access tokens will let you authenticate scripts and tools that interact with your own data.
-
Scoped permissions · You'll be able to request only the access you need: members, fronts, journal, polls, and more.
-
Revocable tokens · Users will be able to review and revoke access for any authorized application at any time.
GET /api/v1/systems/{id}/members
Authorization: Bearer {token}
// Response
{
"data": [
{
"name": "Sage",
"pronouns": "She/her",
"color": "#34d399",
"roles": ["Caretaker"]
}
]
}Want to know when it's ready?
The API is actively in development. Follow our roadmap to stay up to date on progress, and let us know what endpoints and features matter most to you.
View the roadmapPluralSpace is more than an API
While we work on the API, you can already use PluralSpace to manage your system. Create an account and start exploring.