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

# My Cases

> The open cases across the organization's goals whose owner is the signed-in member

## Overview

A member's queue: the organization's open [cases](https://docs.oneshotagent.com/api-reference/compute/cases.md), across all of its goals, whose record names the member as owner.

An owner that is an organization member's email puts the case in that member's queue; the match is case-insensitive on the trimmed address. Any other text is a label only, and the case is in nobody's queue.

A case is open while its `state` is not one of the goal's `finished_states`, and not `unreached` or `cancelled`. An open case is waiting while it sleeps until a time still ahead (`wait_until`), and to do otherwise.

The queue is sorted by `due_date`, soonest first; cases with no due date come last, in the order they were opened. A member acts on a case by [posting to it](https://docs.oneshotagent.com/api-reference/compute/case-events.md).

## Authentication

A signed-in organization member.

## Query Parameters

**limit** `number` (default: 50)

Cases per page, 1 to 200

**cursor** `string`

`page.next_cursor` from the previous answer, sent with the same filters

**goal\_id** `string`

Only this goal's cases

**state** `string`

Only cases in this state

**bucket** `string`

`todo`, in the queue's order, or `waiting`, soonest to wake first

**q** `string`

Search, 1 to 100 characters: part of the case key or its facts, any case

**done** `string`

`recent`: the member's cases that finished in the last seven days instead, newest first. Not with `bucket`

## Summary

`GET /v1/org/cases/mine/summary` counts: `total`, `overdue`, `due_week` (not overdue, due within seven days), `waiting`, `done_recent` (as `done=recent` lists), and `goals` with open cases (`goal_id`, `title`, `queue_title` (case-view queue name or `null`), `count`, `waiting`, `done_recent`) and `states` (`state`, `count`), most cases first. Bare dates and midnight-UTC timestamps (including `update_case` dates) become overdue after their UTC day; other timestamps, at their instant. Undated cases never count toward `overdue` or `due_week`.

## Response

**data** `object[]`

One item per case: `goal_id`, `goal_title`, `key`, `state`, `owner`, `next_action`, `due_date`, `latest_output` (`evidence_key`, the last key the record lists, and `result`, the latest delivered result), `person_actions`, `facts`, `outputs`, `priority_reason`, `recorded`, `last_event` (the latest person action), `timezone`, `country`, `wait_until`, `opened_at` and `ended_at`

**views** `object`

Each goal on the page by id: its case view, the screen a person works its cases on, or `null` while it has none

**page.next\_cursor** `string | null`

Pass as `cursor` for the next page of the same list; `null` on the last

```bash cURL theme={null}
curl "https://win.oneshotagent.com/v1/org/cases/mine?limit=50" \
  -H "Authorization: Bearer <session token>"
```

```json 200 theme={null}
{
  "success": true,
  "data": [
    {
      "goal_id": "3f2b9c1e-8d4a-4f6b-9e2a-7c1d5b8a0f42",
      "goal_title": "Invoices",
      "key": "invoice-2026-10-0007",
      "state": "waiting_on_vendor",
      "next_action": "confirm the total",
      "due_date": "2026-10-15T09:00:00.000Z",
      "latest_output": { "evidence_key": "notes/call.md", "result": null },
      "person_actions": ["approve", "retry"]
    }
  ],
  "page": { "limit": 50, "next_cursor": null }
}
```

## Errors

| Code | Status | When |
| - | - | - |
| `invalid_page` | 400 | `limit` is outside 1 to 200, or `cursor` is not from this list |
| `invalid_filter` | 400 | A malformed `goal_id`, `state`, `bucket`, `q` or `done`, or `bucket` with `done` |
| `member_email_unavailable` | 403 | The signed-in account has no email address, so no case can be in its queue |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.