# Decisions

Source: https://opvs.ai/docs/api/decisions

## `GET` /api/v1/decisions

**Get Decisions**

**Parameters**

- `source` (query, any, optional)
- `due` (query, any, optional)
- `snoozed` (query, string, optional)
- `include` (query, any, optional)
- `audience` (query, string, optional)

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

```python
import httpx

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

```javascript
const resp = await fetch("https://app.opvs.ai/api/v1/decisions", {
  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/decisions", nil)
	req.Header.Set("Authorization", "Bearer <token>")
	resp, _ := http.DefaultClient.Do(req)
	defer resp.Body.Close()
}
```

**Responses**

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

## `GET` /api/v1/decisions/count

**Get Decisions Count**

**Parameters**

- `audience` (query, string, optional)

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

```python
import httpx

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

```javascript
const resp = await fetch("https://app.opvs.ai/api/v1/decisions/count", {
  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/decisions/count", nil)
	req.Header.Set("Authorization", "Bearer <token>")
	resp, _ := http.DefaultClient.Do(req)
	defer resp.Body.Close()
}
```

**Responses**

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

## `PATCH` /api/v1/decisions/{key}/triage

**Patch Decision Triage**

**Parameters**

- `key` (path, string, required)

**Request body**

```bash
curl -X PATCH 'https://app.opvs.ai/api/v1/decisions/{key}/triage' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -d '{
  "decide_by": "2026-01-01T00:00:00Z",
  "snoozed_until": "2026-01-01T00:00:00Z",
  "queue": "string"
}'
```

```python
import httpx

resp = httpx.patch(
    "https://app.opvs.ai/api/v1/decisions/{key}/triage",
    headers={"Authorization": "Bearer <token>", "Content-Type": "application/json"},
    json={"decide_by": "2026-01-01T00:00:00Z", "snoozed_until": "2026-01-01T00:00:00Z", "queue": "string"},
)
resp.raise_for_status()
print(resp.json())
```

```javascript
const resp = await fetch("https://app.opvs.ai/api/v1/decisions/{key}/triage", {
  method: "PATCH",
  headers: { "Authorization": "Bearer <token>", "Content-Type": "application/json" },
  body: JSON.stringify({"decide_by": "2026-01-01T00:00:00Z", "snoozed_until": "2026-01-01T00:00:00Z", "queue": "string"})
});
const data = await resp.json();
console.log(data);
```

```go
package main

import (
	"net/http"
	"strings"
)

func main() {
	body := strings.NewReader(`{"decide_by": "2026-01-01T00:00:00Z", "snoozed_until": "2026-01-01T00:00:00Z", "queue": "string"}`)
	req, _ := http.NewRequest("PATCH", "https://app.opvs.ai/api/v1/decisions/{key}/triage", body)
	req.Header.Set("Authorization", "Bearer <token>")
	req.Header.Set("Content-Type", "application/json")
	resp, _ := http.DefaultClient.Do(req)
	defer resp.Body.Close()
}
```

**Responses**

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

## `POST` /api/v1/decisions/{key}/approve

**Approve Decision**

**Parameters**

- `key` (path, string, required)

**Request body**

```bash
curl -X POST 'https://app.opvs.ai/api/v1/decisions/{key}/approve' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -d '{
  "head_sha": "string"
}'
```

```python
import httpx

resp = httpx.post(
    "https://app.opvs.ai/api/v1/decisions/{key}/approve",
    headers={"Authorization": "Bearer <token>", "Content-Type": "application/json"},
    json={"head_sha": "string"},
)
resp.raise_for_status()
print(resp.json())
```

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

```go
package main

import (
	"net/http"
	"strings"
)

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

**Responses**

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

## `POST` /api/v1/decisions/{key}/reject

**Reject Decision**

**Parameters**

- `key` (path, string, required)

**Request body**

```bash
curl -X POST 'https://app.opvs.ai/api/v1/decisions/{key}/reject' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -d '{
  "head_sha": "string",
  "reason": "string"
}'
```

```python
import httpx

resp = httpx.post(
    "https://app.opvs.ai/api/v1/decisions/{key}/reject",
    headers={"Authorization": "Bearer <token>", "Content-Type": "application/json"},
    json={"head_sha": "string", "reason": "string"},
)
resp.raise_for_status()
print(resp.json())
```

```javascript
const resp = await fetch("https://app.opvs.ai/api/v1/decisions/{key}/reject", {
  method: "POST",
  headers: { "Authorization": "Bearer <token>", "Content-Type": "application/json" },
  body: JSON.stringify({"head_sha": "string", "reason": "string"})
});
const data = await resp.json();
console.log(data);
```

```go
package main

import (
	"net/http"
	"strings"
)

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

**Responses**

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

## `POST` /api/v1/decisions/{key}/answer

**Answer Decision**

**Parameters**

- `key` (path, string, required)

**Request body**

```bash
curl -X POST 'https://app.opvs.ai/api/v1/decisions/{key}/answer' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -d '{
  "message_id": "string",
  "choice_id": "string",
  "task_id": "string",
  "question_asked_at": "string",
  "text": "string"
}'
```

```python
import httpx

resp = httpx.post(
    "https://app.opvs.ai/api/v1/decisions/{key}/answer",
    headers={"Authorization": "Bearer <token>", "Content-Type": "application/json"},
    json={"message_id": "string", "choice_id": "string", "task_id": "string", "question_asked_at": "string", "text": "string"},
)
resp.raise_for_status()
print(resp.json())
```

```javascript
const resp = await fetch("https://app.opvs.ai/api/v1/decisions/{key}/answer", {
  method: "POST",
  headers: { "Authorization": "Bearer <token>", "Content-Type": "application/json" },
  body: JSON.stringify({"message_id": "string", "choice_id": "string", "task_id": "string", "question_asked_at": "string", "text": "string"})
});
const data = await resp.json();
console.log(data);
```

```go
package main

import (
	"net/http"
	"strings"
)

func main() {
	body := strings.NewReader(`{"message_id": "string", "choice_id": "string", "task_id": "string", "question_asked_at": "string", "text": "string"}`)
	req, _ := http.NewRequest("POST", "https://app.opvs.ai/api/v1/decisions/{key}/answer", body)
	req.Header.Set("Authorization", "Bearer <token>")
	req.Header.Set("Content-Type", "application/json")
	resp, _ := http.DefaultClient.Do(req)
	defer resp.Body.Close()
}
```

**Responses**

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

## `PATCH` /api/v1/decisions/{key}/reason

**Patch Decision Reason**

**Parameters**

- `key` (path, string, required)

**Request body**

```bash
curl -X PATCH 'https://app.opvs.ai/api/v1/decisions/{key}/reason' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -d '{
  "reason": "string"
}'
```

```python
import httpx

resp = httpx.patch(
    "https://app.opvs.ai/api/v1/decisions/{key}/reason",
    headers={"Authorization": "Bearer <token>", "Content-Type": "application/json"},
    json={"reason": "string"},
)
resp.raise_for_status()
print(resp.json())
```

```javascript
const resp = await fetch("https://app.opvs.ai/api/v1/decisions/{key}/reason", {
  method: "PATCH",
  headers: { "Authorization": "Bearer <token>", "Content-Type": "application/json" },
  body: JSON.stringify({"reason": "string"})
});
const data = await resp.json();
console.log(data);
```

```go
package main

import (
	"net/http"
	"strings"
)

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

**Responses**

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

## Get Decisions

`GET https://app.opvs.ai/api/v1/decisions`

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

## Get Decisions Count

`GET https://app.opvs.ai/api/v1/decisions/count`

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

## Patch Decision Triage

`PATCH https://app.opvs.ai/api/v1/decisions/{key}/triage`

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

## Approve Decision

`POST https://app.opvs.ai/api/v1/decisions/{key}/approve`

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

## Reject Decision

`POST https://app.opvs.ai/api/v1/decisions/{key}/reject`

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

## Answer Decision

`POST https://app.opvs.ai/api/v1/decisions/{key}/answer`

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

## Patch Decision Reason

`PATCH https://app.opvs.ai/api/v1/decisions/{key}/reason`

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