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

# Nooks: List Call Dispositions

> List the call dispositions (outcomes) set up in your Nooks workspace. Includes SDK V2 guidance, input constraints, response fields, and Deepline credit cost.

List the call dispositions (outcomes) set up in your Nooks workspace.

> [!NOTE]
>
> Tool ID: `nooks_list_call_dispositions`

## Run this action

This action has conditional or dynamic inputs. A static example cannot describe these inputs reliably.

Read the live contract before you execute this action:

```bash theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
deepline describe nooks_list_call_dispositions --json
```

## Example response

The static output schema lacks the details for a reliable example. Use `deepline describe nooks_list_call_dispositions --json` for the complete live contract.

## Input reference

Returns a paginated list of call dispositions for the workspace. Only dispositions with type `nooks_sep` are returned. Example: `bash curl -X GET 'https://partner-api.nooks.in/v1/callDispositions?page[size]=50' \ -H "Authorization: Bearer nooks-api-..." ` Filter by name: `bash curl -X GET 'https://partner-api.nooks.in/v1/callDispositions?filter[name]=Connected' \ -H "Authorization: Bearer nooks-api-..." ` Filter by IDs: `bash curl -X GET 'https://partner-api.nooks.in/v1/callDispositions?filter[id]=UUID1,UUID2' \ -H "Authorization: Bearer nooks-api-..." `

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `payload.page` | `object` | No | — | Number of items per page (max 100) |
| `payload.filter` | `object` | No | — | Filter by IDs (comma-separated UUIDs). An empty value is treated as "no filter". |

<details>
  <summary>Show raw input schema</summary>

  ### Input JSON Schema

  ````json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "Returns a paginated list of call dispositions for the workspace. Only dispositions with type `nooks_sep` are returned. Example: ```bash curl -X GET 'https://partner-api.nooks.in/v1/callDispositions?page[size]=50' \\ -H \"Authorization: Bearer nooks-api-...\" ``` Filter by name: ```bash curl -X GET 'https://partner-api.nooks.in/v1/callDispositions?filter[name]=Connected' \\ -H \"Authorization: Bearer nooks-api-...\" ``` Filter by IDs: ```bash curl -X GET 'https://partner-api.nooks.in/v1/callDispositions?filter[id]=UUID1,UUID2' \\ -H \"Authorization: Bearer nooks-api-...\" ```",
    "properties": {
      "page": {
        "type": "object",
        "description": "Number of items per page (max 100)",
        "properties": {
          "size": {
            "type": "integer",
            "description": "Number of items per page (max 100)",
            "default": 50,
            "minimum": 1,
            "maximum": 100
          },
          "after": {
            "type": "string",
            "description": "Cursor for fetching the next page. Opaque token returned by the API in `links.next`; callers should treat it as opaque and only pass values they received from a previous response. Malformed cursors return `400 Bad Request`."
          },
          "before": {
            "type": "string",
            "description": "Cursor for fetching the previous page. Opaque token returned by the API in `links.prev`; callers should treat it as opaque and only pass values they received from a previous response. Malformed cursors return `400 Bad Request`."
          }
        },
        "required": [],
        "additionalProperties": false
      },
      "filter": {
        "type": "object",
        "description": "Filter by IDs (comma-separated UUIDs). An empty value is treated as \"no filter\".",
        "properties": {
          "id": {
            "type": "string",
            "description": "Filter by IDs (comma-separated UUIDs). An empty value is treated as \"no filter\".",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}(,[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})*)?$"
          },
          "name": {
            "type": "string",
            "description": "Filter dispositions by exact name match"
          }
        },
        "required": [],
        "additionalProperties": false
      }
    },
    "required": [],
    "additionalProperties": false
  }
  ````
</details>

## Output reference

Standard tool result payload.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `result.data` | `object` | Yes | — | Provider response payload. |
| `result.data.data` | `array` | No | — | — |
| `result.data.data[].id` | `string` | Yes | — | Unique identifier for the call disposition Format: `uuid`. |
| `result.data.data[].name` | `string` | Yes | — | Display name of the disposition |
| `result.data.data[].callOutcome` | `string` | Yes | — | The call outcome category this disposition maps to |
| `result.data.data[].order` | `integer \| null` | Yes | — | Sort order for display (null if unordered) |
| `result.data.data[].createdAt` | `string` | Yes | — | When the disposition was created Format: `date-time`. |
| `result.data.data[].updatedAt` | `string` | Yes | — | When the disposition was last updated Format: `date-time`. |
| `result.data.links` | `object` | No | — | Pagination links for navigating through results. Links are returned as relative references (path + query) that should be resolved against the base URL of the request. |
| `result.data.links.first` | `string` | No | — | URL for the first page Format: `uri-reference`. |
| `result.data.links.prev` | `string \| null` | No | — | URL for the previous page (null if on first page) Format: `uri-reference`. |
| `result.data.links.next` | `string \| null` | No | — | URL for the next page (null if on last page) Format: `uri-reference`. |
| `result.meta` | `object` | No | — | Additional response metadata (status, paging). |

<details>
  <summary>Show raw output schema</summary>

  ### Output JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "Standard tool result payload.",
    "properties": {
      "data": {
        "type": "object",
        "description": "Provider response payload.",
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "type": "object",
              "description": "A call disposition definition used to categorize call outcomes",
              "properties": {
                "id": {
                  "type": "string",
                  "description": "Unique identifier for the call disposition",
                  "format": "uuid"
                },
                "name": {
                  "type": "string",
                  "description": "Display name of the disposition"
                },
                "callOutcome": {
                  "type": "string",
                  "description": "The call outcome category this disposition maps to"
                },
                "order": {
                  "type": [
                    "integer",
                    "null"
                  ],
                  "description": "Sort order for display (null if unordered)"
                },
                "createdAt": {
                  "type": "string",
                  "description": "When the disposition was created",
                  "format": "date-time"
                },
                "updatedAt": {
                  "type": "string",
                  "description": "When the disposition was last updated",
                  "format": "date-time"
                }
              },
              "required": [
                "id",
                "name",
                "callOutcome",
                "order",
                "createdAt",
                "updatedAt"
              ],
              "additionalProperties": false
            }
          },
          "links": {
            "type": "object",
            "description": "Pagination links for navigating through results. Links are returned as relative references (path + query) that should be resolved against the base URL of the request.",
            "properties": {
              "first": {
                "type": "string",
                "description": "URL for the first page",
                "format": "uri-reference"
              },
              "prev": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "URL for the previous page (null if on first page)",
                "format": "uri-reference"
              },
              "next": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "URL for the next page (null if on last page)",
                "format": "uri-reference"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "meta": {
        "type": "object",
        "description": "Additional response metadata (status, paging).",
        "additionalProperties": true
      }
    },
    "required": [
      "data"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Deepline cost

* Pricing model: `fixed` (per call).
* Estimated Deepline credits: `0` per pricing unit.
* Provider-native pricing may still exist outside Deepline credit billing.

## Related documentation

* [Nooks provider guide](https://deepline.com/docs/providers/nooks/guide.md)
* [SDK V2 quickstart](https://deepline.com/docs/sdk-v2/quickstart.md)
* [SDK reference](https://deepline.com/docs/sdk-v2/sdk-reference.md)
* [Run tools across a CSV](https://deepline.com/docs/sdk-v2/batch-csv.md)


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