https://github.com/prose-im/prose-pod-api
Prose Pod API server. REST API used for administration and management.
https://github.com/prose-im/prose-pod-api
rest-api xmpp xmpp-servers
Last synced: about 2 months ago
JSON representation
Prose Pod API server. REST API used for administration and management.
- Host: GitHub
- URL: https://github.com/prose-im/prose-pod-api
- Owner: prose-im
- License: mpl-2.0
- Created: 2022-06-17T12:11:36.000Z (almost 4 years ago)
- Default Branch: master
- Last Pushed: 2025-06-19T17:12:27.000Z (10 months ago)
- Last Synced: 2025-06-21T06:34:41.914Z (10 months ago)
- Topics: rest-api, xmpp, xmpp-servers
- Language: Rust
- Homepage: https://prose.org
- Size: 2.97 MB
- Stars: 3
- Watchers: 5
- Forks: 1
- Open Issues: 42
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.md
Awesome Lists containing this project
README
# prose-pod-api
[](https://github.com/prose-im/prose-pod-api/actions/workflows/test.yaml)
**Prose Pod API server. REST API used for administration and management.**
Copyright 2022-2025, Prose Foundation - Released under the [Mozilla Public License 2.0](./LICENSE.md).
_Tested at Rust version: `rustc 1.89.0 (29483883e 2025-08-04)`_
## Quick Start
### Run the API server
The API can be ran with the following command:
```sh
task local:run -- --scenario=demo --ephemeral --api=edge
```
This will run the _latest_ API version, with the _demo scenario_, in _ephemeral mode_. This means that no data will be persisted. Every time you restart the API, you will start from the same fresh demo data again.
The API will be running at [localhost:8080](http://localhost:8080).
### Read the API documentation
To start the API documentation server, run the following command:
```sh
task openapi:preview-docs
```
Then, open the documentation at [localhost:8081](http://localhost:8081).
### Access the fake email inbox
Whenever your API is running, a fake email inbox is also running on the side (for development purposes only). This can be used to test email-related functionality without sending actual emails. For instance, you can use this to test user invitations, receive the invitation email, and accept those invitations with the invitation link.
The fake email inbox Web UI is available at [localhost:8025](http://localhost:8025).
## License
Licensing information can be found in the [LICENSE.md](./LICENSE.md) document.
## :fire: Report A Vulnerability
If you find a vulnerability in any Prose system, you are more than welcome to report it directly to Prose Security by sending an encrypted email to [security@prose.org](mailto:security@prose.org). Do not report vulnerabilities in public GitHub issues, as they may be exploited by malicious people to target production systems running an unpatched version.
**:warning: You must encrypt your email using Prose Security GPG public key: [:key:57A5B260.pub.asc](https://files.prose.org/public/keys/gpg/57A5B260.pub.asc).**