> ## Documentation Index
> Fetch the complete documentation index at: https://docs.projectecho.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Use the Project Echo REST API

> Authenticate and call the Project Echo REST API at api.projectecho.io/v1.

The Project Echo REST API lets you list and manage feedback programmatically. Base URL:

`https://api.projectecho.io/v1`

Create keys under **API & MCP** in the Workspace nav.

## Authentication

Send both headers on every request:

```bash theme={null}
curl -s "https://api.projectecho.io/v1/requests?limit=5" \
  -H "Authorization: Bearer pe_api_YOUR_TOKEN" \
  -H "X-PE-API-Key-Id: YOUR_KEY_ID"
```

## Members vs users

These are different people resources:

* **Members** (`/v1/members`) — portal end-users of your product. Email can be exposed for identify/embed flows.
* **Users** (`/v1/users`) — workspace teammates in the staff app. Email is not returned.

Resolve request authors with `created_by_member_id` → members, or `created_by_user_id` → users.

## Common resources

With the right permissions you can work with:

* Requests (list, get, create, update, delete)
* Comments (public) and internal notes (staff-only)
* Votes
* Members and users
* Boards and statuses

Write actions that act on behalf of a portal member typically need `member_id` or `external_user_id` in the JSON body. Internal notes require an `author_user_id` (teammate UUID).

## Filters

`GET /v1/requests` supports filters such as `board_id`, `status_id`, `created_by_user_id`, plus `limit` and `offset`.

## Tips

* Start with a read-only key while exploring.
* Public comments endpoints exclude internal notes — use the internal-notes paths for staff-only content.
* Prefer MCP when you want AI tools (Claude, Cursor) to call the same capabilities through tools instead of raw HTTP.

Full permission presets are chosen when you create the key. Questions: [support@projectecho.io](mailto:support@projectecho.io) · [Help Center](https://docs.projectecho.io/).


## Related topics

- [Create and manage API keys](/api-mcp-and-embed/create-manage-api-keys.md)
- [Connect AI tools with MCP (Claude, Cursor, and others)](/api-mcp-and-embed/connect-mcp.md)
- [Embed Project Echo in your product (My app / identify users)](/api-mcp-and-embed/embed-my-app.md)
- [What is Project Echo?](/getting-started/what-is-project-echo.md)
- [Tour of the staff app (Requests, Roadmap, Changelog, Members, Settings)](/getting-started/tour-of-the-staff-app.md)