canonical: https://jentic.com/apis/uservoice.com/uservoice

# UserVoice API

UserVoice is a product management and customer feedback platform. The API provides operations for managing suggestions, forums, users, tickets, and feedback. The API exposes 19 endpoints secured with oauth2 authentication.

## For AI agents

Programmatically list suggestions, retrieve a suggestion. Covers 19 operations with oauth2 authentication.

## Scope

Does not handle payments, communications, or crm - use for e-commerce only.

## Capabilities

- List suggestions
- Retrieve a suggestion
- Update a suggestion
- Convert suggestion to ticket
- Add a comment

## Use cases

### E-Commerce Operations

Use the UserVoice API to perform e commerce operations programmatically. The API provides 19 endpoints covering core functionality including list suggestions, retrieve a suggestion, update a suggestion.

Example prompt: Call GET /admin/suggestions to list suggestions

### Automated Categories Management

Automate categories operations by combining multiple UserVoice API endpoints. Agents can retrieve a suggestion and then update a suggestion in a single workflow.

Example prompt: Call GET /admin/suggestions/{id} to retrieve a suggestion, then verify the result

### AI Agent Integration via Jentic

AI agents discover and call UserVoice API endpoints through Jentic without managing credentials directly. An agent searches for the required operation by intent, receives the matching endpoint schema, and executes the call with Jentic-managed authentication. This eliminates the need to read API documentation or handle oauth2 tokens manually.

Example prompt: Search Jentic for 'list suggestions', load the operation schema, and execute with Jentic-managed credentials

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| GET | /admin/suggestions | List suggestions |
| GET | /admin/suggestions/{id} | Retrieve a suggestion |
| PUT | /admin/suggestions/{id} | Update a suggestion |
| PUT | /admin/suggestions/{id}/convert | Convert suggestion to ticket |
| POST | /admin/suggestions/{suggestionId}/comments | Add a comment |
| GET | /admin/suggestions/{suggestionId}/comments | List comments on a suggestion |
| GET | /admin/forums | List forums |
| GET | /admin/forums/{id} | Retrieve a forum |

## Key resources

- **Categories** — Operations related to Categories
- **Comments** — Operations related to Comments
- **Features** — Operations related to Features
- **Forums** — Operations related to Forums
- **Labels** — Operations related to Labels

## Why Jentic

- **Setup:** Wiring the UserVoice API by hand means running its OAuth2 flow, resolving your subdomain into the host, and threading the token through the admin suggestion and forum endpoints yourself. Through Jentic you install once, import UserVoice from the API Directory, store the credential once, and your agent calls it.
- **Permission scoping:** UserVoice puts the suggestion id in the URL path (/admin/suggestions/{id}), so a rule can pin your agent to one suggestion: it can read and update that suggestion if you allow it. You choose the operations it may call, so state-changing ones like converting a suggestion are not included unless you add them.
- **Credential handling:** Your UserVoice OAuth2 credential is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'list suggestions' or 'comment on a suggestion', and Jentic returns the matching UserVoice operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

## Related APIs

- **Shopify** — Alternative e commerce API
- **Stripe** — Alternative e commerce API

## FAQ

### What authentication does the UserVoice API use?

The UserVoice API uses OAuth 2.0 for authorization. Through Jentic, these credentials are stored encrypted in your Jentic One instance and injected at execution time, so raw secrets never enter the agent context.

### Can I list suggestions with the UserVoice API?

Yes. Use the GET /admin/suggestions endpoint. The API returns structured JSON responses that agents can parse and act on directly.

### What are the rate limits for the UserVoice API?

Rate limits are not specified in the OpenAPI spec. Check the vendor documentation for current limits. Through Jentic, rate limiting is handled automatically with retry logic built into the execution layer.

### How do I list suggestions through Jentic?

Install the Jentic SDK with pip install jentic, authenticate through Jentic One, the self-hosted execution layer, then search for 'list suggestions'. Jentic returns the matching UserVoice API operation with its input schema. Load the schema and execute the call - credentials are injected automatically.

### How many endpoints does the UserVoice API have?

The UserVoice API exposes 19 endpoints covering categories, comments, features operations.

### Can I limit what my agent is allowed to do with the UserVoice API?

Yes. Because you run Jentic One yourself, your own rules decide which UserVoice operations and credentials the agent may use. Since the suggestion id sits in the URL path (/admin/suggestions/{id}), you can pin the agent to a single suggestion and let it only read or update that one. State-changing operations like converting a suggestion to a ticket or adding a comment are excluded unless you explicitly grant them.