# List process definitions

> `GET` `/v1/process-definition-tools`

URL: https://www.agencytitan.com/docs/tag/process-definition-tools/GET/v1/process-definition-tools

Operation ID: `process_definition_tools_list`

Tag: [process_definition_tools](https://www.agencytitan.com/docs/tag/process-definition-tools.md)

## Description

List process definitions by name, id, description, and stage count.

Use this to browse process definitions before selecting one to inspect, update, or delete. When multiple keywords are provided, all keywords must match the process name or description.

## Parameters

- `keywords` (query, optional, `array<string>`) — Optional search keywords. A process is included if its name or description matches ANY of these keywords (case-insensitive substring). Prefer a few short, root…
- `limit` (query, optional, `integer`) — Maximum number of items to return (1-200).
- `offset` (query, optional, `integer`) — Number of items to skip before collecting the result set.
- `order` (query, optional, `string`) — Sort direction. Default `asc`.
- `sort` (query, optional, `string`) — Field to sort by. Default `name`.

## Request body

_None_

## Responses

- `200` (`application/json`): Successful response.
  - Type: `object`
  - Properties:
    - `data` (`array<object>`, required)
    - `pagination` (`object`, required)
- `400` (`application/json`): Request validation failed (unknown or out-of-range parameters/properties are rejected).
  - Type: `object`
  - Properties:
    - `error` (`object`, required)
- `401` (`application/json`): Missing, invalid, expired, or revoked bearer token.
  - Type: `object`
  - Properties:
    - `error` (`string`, required)
    - `error_description` (`string`, required)
- `403` (`application/json`): The authenticated user does not have permission for this operation.
  - Type: `object`
  - Properties:
    - `error` (`object`, required)
- `404` (`application/json`): The requested resource was not found.
  - Type: `object`
  - Properties:
    - `error` (`object`, required)
- `429` (`application/json`): Per-tenant rate limit exceeded (600 requests/minute across all /v1 REST endpoints). The Retry-After header indicates how many seconds to wait.
  - Type: `object`
  - Properties:
    - `error` (`object`, required)
- `500` (`application/json`): An unexpected internal error occurred.
  - Type: `object`
  - Properties:
    - `error` (`object`, required)

## Authentication

- `bearerAuth` — http (bearer) — All /v1 endpoints (except `/v1/openapi.json` and `/v1/llms.txt`) require a bearer token. Two equal first-class paths: (1) an OAuth 2.0 access token from the au…

## Useful links

- Interactive page: https://www.agencytitan.com/docs/tag/process-definition-tools/GET/v1/process-definition-tools
- API reference home: https://www.agencytitan.com/docs/
- Tag page: https://www.agencytitan.com/docs/tag/process-definition-tools.md
- This operation as Markdown: https://www.agencytitan.com/docs/tag/process-definition-tools/GET/v1/process-definition-tools.md
- OpenAPI JSON: https://www.agencytitan.com/docs/openapi.json
- Full API Markdown: https://api.agencytitan.com/v1/llms.txt
- API keys: https://app.agencytitan.com/settings/api-mcp