# Factory Reviews

Source: https://opvs.ai/docs/api/factory-reviews

## `GET` /api/v1/factory/reviews

**List Reviews**

This brand's reviews of one of its builder hires, most recent first.

**Parameters**

- `builder_hire_id` (query, string, required) — agent_hires.id of the builder
- `limit` (query, integer, optional)

```bash
curl -X GET 'https://app.opvs.ai/api/v1/factory/reviews' \
  -H 'Authorization: Bearer <token>'
```

```python
import httpx

resp = httpx.get(
    "https://app.opvs.ai/api/v1/factory/reviews",
    headers={"Authorization": "Bearer <token>"},
)
resp.raise_for_status()
print(resp.json())
```

```javascript
const resp = await fetch("https://app.opvs.ai/api/v1/factory/reviews", {
  method: "GET",
  headers: { "Authorization": "Bearer <token>" }
});
const data = await resp.json();
console.log(data);
```

```go
package main

import (
	"net/http"
)

func main() {
	req, _ := http.NewRequest("GET", "https://app.opvs.ai/api/v1/factory/reviews", nil)
	req.Header.Set("Authorization", "Bearer <token>")
	resp, _ := http.DefaultClient.Do(req)
	defer resp.Body.Close()
}
```

**Responses**

- `200` — Successful Response
- `422` — Validation Error

## `POST` /api/v1/factory/reviews

**Submit Review**

Submit (or update) this brand's review of a builder it hired.

**Request body**

```bash
curl -X POST 'https://app.opvs.ai/api/v1/factory/reviews' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -d '{
  "builder_hire_id": "string",
  "rating": 0,
  "comment": "string"
}'
```

```python
import httpx

resp = httpx.post(
    "https://app.opvs.ai/api/v1/factory/reviews",
    headers={"Authorization": "Bearer <token>", "Content-Type": "application/json"},
    json={"builder_hire_id": "string", "rating": 0, "comment": "string"},
)
resp.raise_for_status()
print(resp.json())
```

```javascript
const resp = await fetch("https://app.opvs.ai/api/v1/factory/reviews", {
  method: "POST",
  headers: { "Authorization": "Bearer <token>", "Content-Type": "application/json" },
  body: JSON.stringify({"builder_hire_id": "string", "rating": 0, "comment": "string"})
});
const data = await resp.json();
console.log(data);
```

```go
package main

import (
	"net/http"
	"strings"
)

func main() {
	body := strings.NewReader(`{"builder_hire_id": "string", "rating": 0, "comment": "string"}`)
	req, _ := http.NewRequest("POST", "https://app.opvs.ai/api/v1/factory/reviews", body)
	req.Header.Set("Authorization", "Bearer <token>")
	req.Header.Set("Content-Type", "application/json")
	resp, _ := http.DefaultClient.Do(req)
	defer resp.Body.Close()
}
```

**Responses**

- `201` — Successful Response
- `422` — Validation Error

## `POST` /api/v1/factory/reviews/request

**Request Review**

Emit ``review.requested`` to prompt this brand to review a builder.

**Request body**

```bash
curl -X POST 'https://app.opvs.ai/api/v1/factory/reviews/request' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -d '{
  "builder_hire_id": "string",
  "persona_name": "string",
  "role": "string",
  "runs": 0
}'
```

```python
import httpx

resp = httpx.post(
    "https://app.opvs.ai/api/v1/factory/reviews/request",
    headers={"Authorization": "Bearer <token>", "Content-Type": "application/json"},
    json={"builder_hire_id": "string", "persona_name": "string", "role": "string", "runs": 0},
)
resp.raise_for_status()
print(resp.json())
```

```javascript
const resp = await fetch("https://app.opvs.ai/api/v1/factory/reviews/request", {
  method: "POST",
  headers: { "Authorization": "Bearer <token>", "Content-Type": "application/json" },
  body: JSON.stringify({"builder_hire_id": "string", "persona_name": "string", "role": "string", "runs": 0})
});
const data = await resp.json();
console.log(data);
```

```go
package main

import (
	"net/http"
	"strings"
)

func main() {
	body := strings.NewReader(`{"builder_hire_id": "string", "persona_name": "string", "role": "string", "runs": 0}`)
	req, _ := http.NewRequest("POST", "https://app.opvs.ai/api/v1/factory/reviews/request", body)
	req.Header.Set("Authorization", "Bearer <token>")
	req.Header.Set("Content-Type", "application/json")
	resp, _ := http.DefaultClient.Do(req)
	defer resp.Body.Close()
}
```

**Responses**

- `202` — Successful Response
- `422` — Validation Error

## `DELETE` /api/v1/factory/reviews/{review_id}

**Delete Review**

Retract this brand's own review (verified-hire self-moderation).

**Parameters**

- `review_id` (path, string, required)

```bash
curl -X DELETE 'https://app.opvs.ai/api/v1/factory/reviews/{review_id}' \
  -H 'Authorization: Bearer <token>'
```

```python
import httpx

resp = httpx.delete(
    "https://app.opvs.ai/api/v1/factory/reviews/{review_id}",
    headers={"Authorization": "Bearer <token>"},
)
resp.raise_for_status()
print(resp.json())
```

```javascript
const resp = await fetch("https://app.opvs.ai/api/v1/factory/reviews/{review_id}", {
  method: "DELETE",
  headers: { "Authorization": "Bearer <token>" }
});
const data = await resp.json();
console.log(data);
```

```go
package main

import (
	"net/http"
)

func main() {
	req, _ := http.NewRequest("DELETE", "https://app.opvs.ai/api/v1/factory/reviews/{review_id}", nil)
	req.Header.Set("Authorization", "Bearer <token>")
	resp, _ := http.DefaultClient.Do(req)
	defer resp.Body.Close()
}
```

**Responses**

- `204` — Successful Response
- `422` — Validation Error

## List Reviews

`GET https://app.opvs.ai/api/v1/factory/reviews`

Also as: MCP `tool_call software-factory.listBuilderReviews` · skill `software-factory`

This brand's reviews of one of its builder hires, most recent first.

| Code | When | What to do |
| --- | --- | --- |
| 422 | Validation Error |  |

## Submit Review

`POST https://app.opvs.ai/api/v1/factory/reviews`

Also as: MCP `tool_call software-factory.submitBuilderReview` · skill `software-factory`

Submit (or update) this brand's review of a builder it hired.

| Code | When | What to do |
| --- | --- | --- |
| 422 | Validation Error |  |

## Request Review

`POST https://app.opvs.ai/api/v1/factory/reviews/request`

Also as: MCP `tool_call software-factory.requestBuilderReview` · skill `software-factory`

Emit ``review.requested`` to prompt this brand to review a builder.

| Code | When | What to do |
| --- | --- | --- |
| 422 | Validation Error |  |

## Delete Review

`DELETE https://app.opvs.ai/api/v1/factory/reviews/{review_id}`

Also as: MCP `tool_call software-factory.deleteBuilderReview` · skill `software-factory`

Retract this brand's own review (verified-hire self-moderation).

| Code | When | What to do |
| --- | --- | --- |
| 422 | Validation Error |  |