Feature Requests API

liveOpenAPI 3.1

A demo hosted API for collecting and prioritizing product feedback.

Maintained by endpointos-demoUpdated May 12, 20261 resource1,000 requests/month

Introduction

A live REST API reference generated from Feature Requests API.

This documentation is generated from the project schema in EndpointOS. It shows the public method surface, authentication model, request schemas, response contracts, errors, pagination, usage limits, and OpenAPI export.

Quickstart

Make the first request

Use a project API key with the base URL and one of the generated resource paths. EndpointOS never displays private API keys in public documentation.

Issue a read or write key from the project dashboard.
Send it in Authorization: Bearer sapi_live_xxxxxxxx or x-api-key.
Call one of the generated endpoints below.
Inspect the request log and monthly usage in EndpointOS.

Run it/feature-requests

curl "https://endpointos.dev/api/public/endpointos-demo/feature-requests-api/feature-requests?limit=20&offset=0" \
  -H "Authorization: Bearer sapi_live_xxxxxxxx"

Response contractJSON envelope

{
  "data": [],
  "pagination": {
    "limit": 20,
    "offset": 0,
    "total": 0
  }
}

Authentication

API keys on every request

Every public request requires an EndpointOS API key. Key permissions are checked first, then each resource access mode decides which generated methods are exposed.

Header	Value	Use when
`Authorization`	`Bearer sapi_live_xxxxxxxx`	Recommended for server-to-server calls.
`x-api-key`	`sapi_test_xxxxxxxx`	Useful for curl examples and simple clients.

HeadersEither format works

Authorization: Bearer sapi_live_xxxxxxxx

x-api-key: sapi_test_xxxxxxxx

Base URL

Project-level API namespace

All endpoints below are relative to this base URL. The username and project slug are part of the namespace so different builders can publish APIs with the same project name without collisions.

https://endpointos.dev/api/public/endpointos-demo/feature-requests-api

Resource behavior

Access modes and data sources

Each resource controls its public method surface. API key permissions still apply, but a resource can intentionally expose fewer methods for dataset, lookup, or intake APIs.

Read/write

GET, POST, PATCH, DELETEManaged APIs that need the full record lifecycle.

Read-only

GETPublic datasets, reporting feeds, lookup APIs, and partner data products.

Write-only

POSTLead capture, form submissions, events, and private intake APIs.

Resource

feature-requests

/feature-requests

Feature request records available through the generated CRUD API.

feature-requestsEndpointOS managedRead/write5 endpoints

Field	Type	Required	Unique	Default	Enum values	Notes
`title`	`string`	Yes	No	None	None	Required on create. String value
`description`	`string`	No	No	None	None	String value
`submitterEmail`	`string`	Yes	No	None	None	Required on create. String value
`status`	`enum`	No	No	None	new, planned, inProgress, shipped, closed	Must match one enum value
`priority`	`enum`	No	No	None	low, medium, high	Must match one enum value
`votes`	`number`	No	No	None	None	Finite numeric value
`isPublic`	`boolean`	No	No	None	None	true or false

titlestring

Required: Yes
Unique: No
Default: None
Enum: None
Notes: Required on create. String value

descriptionstring

Required: No
Unique: No
Default: None
Enum: None
Notes: String value

submitterEmailstring

Required: Yes
Unique: No
Default: None
Enum: None
Notes: Required on create. String value

statusenum

Required: No
Unique: No
Default: None
Enum: new, planned, inProgress, shipped, closed
Notes: Must match one enum value

priorityenum

Required: No
Unique: No
Default: None
Enum: low, medium, high
Notes: Must match one enum value

votesnumber

Required: No
Unique: No
Default: None
Enum: None
Notes: Finite numeric value

isPublicboolean

Required: No
Unique: No
Default: None
Enum: None
Notes: true or false

GET/feature-requests

List feature-requests

Returns non-deleted records with pagination, filters, search, and sorting.

API key requiredRead-only or read-writeLogs every request

Request body

This endpoint does not accept a request body.

Possible responses

`200`OK	success	Request succeeded and returned a JSON response.
`401`Unauthorized	client	Missing or invalid API key.
`429`Rate limited	client	The project reached its monthly request limit.

RequestGET /feature-requests

curl "https://endpointos.dev/api/public/endpointos-demo/feature-requests-api/feature-requests" \
  -H "Authorization: Bearer sapi_live_xxxxxxxx"

Response example200 OK

{
  "data": [
    {
      "id": "rec_abc123",
      "title": "Dark mode",
      "description": "Add a darker theme for late-night work sessions.",
      "submitterEmail": "founder@example.com",
      "status": "new",
      "priority": "low",
      "votes": 42,
      "isPublic": true,
      "createdAt": "2026-05-11T10:30:00.000Z",
      "updatedAt": "2026-05-11T10:30:00.000Z"
    }
  ],
  "pagination": {
    "limit": 20,
    "offset": 0,
    "total": 1
  }
}

Error exampleConsistent error object

{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "A valid EndpointOS API key is required.",
    "details": {}
  }
}

POST/feature-requests

Create a feature-request

Validates the JSON body against the resource schema and creates a record.

API key requiredRead-writeLogs every request

Request body

Field	Type	Required	Notes
`title`	string	Yes	Required on create. String value
`description`	string	No	String value
`submitterEmail`	string	Yes	Required on create. String value
`status`	enum	No	Must match one enum value
`priority`	enum	No	Must match one enum value
`votes`	number	No	Finite numeric value
`isPublic`	boolean	No	true or false

titlestring

Required: Yes
Notes: Required on create. String value

descriptionstring

Required: No
Notes: String value

submitterEmailstring

Required: Yes
Notes: Required on create. String value

statusenum

Required: No
Notes: Must match one enum value

priorityenum

Required: No
Notes: Must match one enum value

votesnumber

Required: No
Notes: Finite numeric value

isPublicboolean

Required: No
Notes: true or false

Possible responses

`201`Created	success	Record created and returned in the data envelope.
`400`Validation error	client	Required, typed, enum, or unknown-field validation failed.
`401`Unauthorized	client	Missing or invalid API key.
`403`Forbidden	client	The key or resource access mode does not permit this method.
`429`Rate limited	client	The project reached its monthly request limit.

RequestPOST /feature-requests

curl -X POST "https://endpointos.dev/api/public/endpointos-demo/feature-requests-api/feature-requests" \
  -H "Authorization: Bearer sapi_live_xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"title":"Dark mode","description":"Add a darker theme for late-night work sessions.","submitterEmail":"founder@example.com","status":"new","priority":"low","votes":42,"isPublic":true}'

Response example201 Created

{
  "data": {
    "id": "rec_abc123",
    "title": "Team workspace",
    "description": "Let teams share one API project workspace.",
    "submitterEmail": "founder@example.com",
    "status": "new",
    "priority": "low",
    "votes": 42,
    "isPublic": true,
    "createdAt": "2026-05-11T10:30:00.000Z",
    "updatedAt": "2026-05-11T10:42:00.000Z"
  }
}

Error exampleConsistent error object

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Unknown field 'unexpected' is not defined on this resource.",
    "details": {
      "field": "unexpected"
    }
  }
}

GET/feature-requests/{id}

Retrieve a feature-request

Returns one non-deleted record by id.

API key requiredRead-only or read-writeLogs every request

Request body

This endpoint does not accept a request body.

Possible responses

`200`OK	success	Request succeeded and returned a JSON response.
`401`Unauthorized	client	Missing or invalid API key.
`404`Not found	client	The record id does not exist or was soft-deleted.
`429`Rate limited	client	The project reached its monthly request limit.

RequestGET /feature-requests/{id}

curl "https://endpointos.dev/api/public/endpointos-demo/feature-requests-api/feature-requests/rec_abc123" \
  -H "Authorization: Bearer sapi_live_xxxxxxxx"

Response example200 OK

{
  "data": {
    "id": "rec_abc123",
    "title": "Team workspace",
    "description": "Let teams share one API project workspace.",
    "submitterEmail": "founder@example.com",
    "status": "new",
    "priority": "low",
    "votes": 42,
    "isPublic": true,
    "createdAt": "2026-05-11T10:30:00.000Z",
    "updatedAt": "2026-05-11T10:42:00.000Z"
  }
}

Error exampleConsistent error object

{
  "error": {
    "code": "RECORD_NOT_FOUND",
    "message": "Record not found.",
    "details": {
      "id": "rec_abc123"
    }
  }
}

PATCH/feature-requests/{id}

Update a feature-request

Accepts a partial JSON body and validates any supplied fields.

API key requiredRead-writeLogs every request

Request body

Field	Type	Required	Notes
`title`	string	No	Optional on PATCH.
`description`	string	No	Optional on PATCH.
`submitterEmail`	string	No	Optional on PATCH.
`status`	enum	No	Optional on PATCH.
`priority`	enum	No	Optional on PATCH.
`votes`	number	No	Optional on PATCH.
`isPublic`	boolean	No	Optional on PATCH.

titlestring

Required: No
Notes: Optional on PATCH.

descriptionstring

Required: No
Notes: Optional on PATCH.

submitterEmailstring

Required: No
Notes: Optional on PATCH.

statusenum

Required: No
Notes: Optional on PATCH.

priorityenum

Required: No
Notes: Optional on PATCH.

votesnumber

Required: No
Notes: Optional on PATCH.

isPublicboolean

Required: No
Notes: Optional on PATCH.

Possible responses

`200`OK	success	Request succeeded and returned a JSON response.
`400`Validation error	client	Required, typed, enum, or unknown-field validation failed.
`401`Unauthorized	client	Missing or invalid API key.
`403`Forbidden	client	The key or resource access mode does not permit this method.
`404`Not found	client	The record id does not exist or was soft-deleted.
`429`Rate limited	client	The project reached its monthly request limit.

RequestPATCH /feature-requests/{id}

curl -X PATCH "https://endpointos.dev/api/public/endpointos-demo/feature-requests-api/feature-requests/rec_abc123" \
  -H "Authorization: Bearer sapi_live_xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"title":"Team workspace","description":"Let teams share one API project workspace."}'

Response example200 OK

{
  "data": {
    "id": "rec_abc123",
    "title": "Team workspace",
    "description": "Let teams share one API project workspace.",
    "submitterEmail": "founder@example.com",
    "status": "new",
    "priority": "low",
    "votes": 42,
    "isPublic": true,
    "createdAt": "2026-05-11T10:30:00.000Z",
    "updatedAt": "2026-05-11T10:42:00.000Z"
  }
}

Error exampleConsistent error object

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Unknown field 'unexpected' is not defined on this resource.",
    "details": {
      "field": "unexpected"
    }
  }
}

DELETE/feature-requests/{id}

Delete a feature-request

Soft deletes the record. List endpoints exclude deleted records.

API key requiredRead-writeLogs every request

Request body

This endpoint does not accept a request body.

Possible responses

`200`OK	success	Request succeeded and returned a JSON response.
`401`Unauthorized	client	Missing or invalid API key.
`403`Forbidden	client	The key or resource access mode does not permit this method.
`404`Not found	client	The record id does not exist or was soft-deleted.
`429`Rate limited	client	The project reached its monthly request limit.

RequestDELETE /feature-requests/{id}

curl -X DELETE "https://endpointos.dev/api/public/endpointos-demo/feature-requests-api/feature-requests/rec_abc123" \
  -H "Authorization: Bearer sapi_live_xxxxxxxx"

Response example200 OK

{
  "data": {
    "id": "rec_abc123",
    "deleted": true
  }
}

Error exampleConsistent error object

{
  "error": {
    "code": "RECORD_NOT_FOUND",
    "message": "Record not found.",
    "details": {
      "id": "rec_abc123"
    }
  }
}

Conventions

Pagination

List endpoints support limit and offset. The default limit is 20 and the maximum limit is 100.

Query parameters

`limit`number	optional	Page size. Defaults to 20 and caps at 100.
`offset`number	optional	Zero-based offset for the first returned record.

List responsePaginated

{
  "data": [
    {
      "id": "rec_abc123",
      "title": "Dark mode",
      "createdAt": "2026-05-11T10:30:00.000Z",
      "updatedAt": "2026-05-11T10:30:00.000Z"
    }
  ],
  "pagination": {
    "limit": 20,
    "offset": 0,
    "total": 1
  }
}

Conventions

Filtering

Collection endpoints accept field filters, comparison operators, text search, and deterministic sorting. Plain field=value remains an equality filter.

Filter controls

`field=value`string	optional	Equality filter for a defined field.
`field[ne]`string	optional	Exclude records matching this value.
`field[in]`string	optional	Comma-separated values for a field.
`field[gte]`string	optional	Comparison operators work with number, date, and datetime fields.
`q`string	optional	Search string and enum fields.
`sort`string	optional	Sort by a field, createdAt, or updatedAt.

Filtered requestGET

GET /feature-requests?status[in]=new,planned&votes[gte]=10&sort=-createdAt

Conventions

Errors

EndpointOS returns stable error codes so clients can handle validation, auth, missing records, and usage limits without parsing prose.

Code	Status	Meaning
`UNAUTHORIZED`	401	Missing, malformed, or invalid API key.
`FORBIDDEN`	403	The API key cannot perform this operation.
`PROJECT_NOT_FOUND`	404	The project slug does not resolve to an API.
`RESOURCE_NOT_FOUND`	404	The resource slug does not exist in the project.
`RECORD_NOT_FOUND`	404	The record id does not exist or was deleted.
`VALIDATION_ERROR`	400	The request body failed schema validation.
`RATE_LIMITED`	429	The project has reached its monthly request limit.
`INTERNAL_ERROR`	500	EndpointOS could not complete the request.

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Field 'title' is required.",
    "details": {
      "field": "title"
    }
  }
}

Conventions

Rate limits

EndpointOS counts public API requests per project each month. When the project reaches its limit, the API returns 429 RATE_LIMITED.

Limit response429 RATE_LIMITED

{
  "error": {
    "code": "RATE_LIMITED",
    "message": "Monthly request limit exceeded.",
    "details": {
      "limit": 1000,
      "resetAt": "2026-06-01T00:00:00.000Z"
    }
  }
}

Validation policy

Unknown fields are rejected

EndpointOS rejects fields that are not defined on the resource schema. This keeps generated APIs predictable and prevents accidental writes to undeclared data.