> You are reading the Docusign Developer Documentation. For clean Markdown of any page, append .md to the page URL.
>
> Documentation indexes by section:
> - APIs and SDKs: https://docusign.docs.buildwithfern.com/docs/llms.txt
> - Platform 101: https://docusign.docs.buildwithfern.com/platform/llms.txt
> - Extension Apps: https://docusign.docs.buildwithfern.com/extension-apps/llms.txt
> - Docusign CLI: https://docusign.docs.buildwithfern.com/docusign-cli/llms.txt
>
> Authentication (OAuth, JWT Grant, M2M): https://docusign.docs.buildwithfern.com/platform/auth
> Webhooks and Connect: https://docusign.docs.buildwithfern.com/platform/webhooks
>
> OpenAPI specifications: https://docusign.docs.buildwithfern.com/openapi.json
> MCP server: https://docusign.docs.buildwithfern.com/_mcp/server

# List available workflow builder workflows

GET https://api-d.docusign.com/v1/accounts/{accountId}/workflows

This operation retrieves a list of all available Workflow Builder workflows. It returns basic information
about each workflow, including its unique identifier (`id`), name, description, and the input
schema required to trigger the workflow.

The response provides key details that help users identify which workflows are available
and understand the input requirements for triggering each one. Each workflow entry also includes
metadata, such as when it was created, last modified, and by whom.

This operation is useful for obtaining an overview of all workflows within the system, helping
users and systems know what workflows are defined, what inputs they require, and how they can
be triggered.

### Use Cases:
- Listing all available workflows in a system for manual or automated workflow initiation.
- Reviewing the input requirements for a workflow before triggering it programmatically.
- Gathering basic metadata about workflows for auditing, logging, or reporting purposes.

### Key Features:
- **Comprehensive Workflow Overview**: Provides a full list of workflows, giving visibility
  into all the automated processes available within the Workflow Builder platform.
- **Input Schema Information**: Each workflow includes its trigger input schema, showing
  what data must be provided when triggering the workflow.
- **Metadata for Tracking**: Useful metadata like creation time, last modification date,
  and user details are included to support tracking and auditing workflows.
- **Future-Proof**: The operation is designed to be expandable as more workflows are added
  or the platform grows, ensuring scalability in the workflow management process.


Reference: https://developers.docusign.com/docs/workflow-builder-api/reference/workflowbuilder/workflows/getworkflowslist

## Authentication

- `Authorization` header (bearer token, required) — OAuth2 authentication. - Demo: - authorizationUrl: https://account-d.docusign.com/oauth/auth - tokenUrl: https://account-d.docusign.com/oauth/token - Production: - authorizationUrl: https://account.docusign.com/oauth/auth - tokenUrl: https://account.docusign.com/oauth/token

## Servers

- `https://api-d.docusign.com` (Demo, default)
- `https://api.docusign.com` (Production)

## Request

### Path parameters

- `accountId` (string, required) — The unique identifier of the account.

## Response

### 200

A list of workflows has been successfully returned.

- `data` (list of Workflow, optional) — A list of workflows
- `response_metadata` (ResponseMetadata, optional) — Additional server-side metadata for a given response

## Errors

### 400 Bad Request Error

Bad Request - The request could not be understood or was missing required parameters.

- `type` (string, required) — A URI reference that identifies the problem type. Use 'about:blank' when the problem has no additional semantics beyond the HTTP status code.
- `title` (string, required) — A short, human-readable summary of the problem type.
- `status` (integer, required) — The HTTP status code.
- `detail` (string, optional) — A human-readable explanation specific to this occurrence of the problem.
- `instance` (string, optional) — A URI reference that identifies the specific occurrence of the problem (typically the request path).
- `timestamp` (datetime, optional) — The timestamp when the error occurred.
- `request_id` (string, optional) — Correlation identifier for the request, useful for support investigations.
- `errors` (list of ValidationError, optional) — Optional list of individual validation or domain errors.

### 401 Unauthorized Error

Unauthorized - Authentication is required and has failed or not been provided.

- `type` (string, required) — A URI reference that identifies the problem type. Use 'about:blank' when the problem has no additional semantics beyond the HTTP status code.
- `title` (string, required) — A short, human-readable summary of the problem type.
- `status` (integer, required) — The HTTP status code.
- `detail` (string, optional) — A human-readable explanation specific to this occurrence of the problem.
- `instance` (string, optional) — A URI reference that identifies the specific occurrence of the problem (typically the request path).
- `timestamp` (datetime, optional) — The timestamp when the error occurred.
- `request_id` (string, optional) — Correlation identifier for the request, useful for support investigations.
- `errors` (list of ValidationError, optional) — Optional list of individual validation or domain errors.

### 403 Forbidden Error

Forbidden - The request was valid, but you do not have permission to perform the action.

- `type` (string, required) — A URI reference that identifies the problem type. Use 'about:blank' when the problem has no additional semantics beyond the HTTP status code.
- `title` (string, required) — A short, human-readable summary of the problem type.
- `status` (integer, required) — The HTTP status code.
- `detail` (string, optional) — A human-readable explanation specific to this occurrence of the problem.
- `instance` (string, optional) — A URI reference that identifies the specific occurrence of the problem (typically the request path).
- `timestamp` (datetime, optional) — The timestamp when the error occurred.
- `request_id` (string, optional) — Correlation identifier for the request, useful for support investigations.
- `errors` (list of ValidationError, optional) — Optional list of individual validation or domain errors.

### 404 Not Found Error

Not Found - The requested resource could not be found.

- `type` (string, required) — A URI reference that identifies the problem type. Use 'about:blank' when the problem has no additional semantics beyond the HTTP status code.
- `title` (string, required) — A short, human-readable summary of the problem type.
- `status` (integer, required) — The HTTP status code.
- `detail` (string, optional) — A human-readable explanation specific to this occurrence of the problem.
- `instance` (string, optional) — A URI reference that identifies the specific occurrence of the problem (typically the request path).
- `timestamp` (datetime, optional) — The timestamp when the error occurred.
- `request_id` (string, optional) — Correlation identifier for the request, useful for support investigations.
- `errors` (list of ValidationError, optional) — Optional list of individual validation or domain errors.

### 500 Internal Server Error

Internal Server Error

- `type` (string, required) — A URI reference that identifies the problem type. Use 'about:blank' when the problem has no additional semantics beyond the HTTP status code.
- `title` (string, required) — A short, human-readable summary of the problem type.
- `status` (integer, required) — The HTTP status code.
- `detail` (string, optional) — A human-readable explanation specific to this occurrence of the problem.
- `instance` (string, optional) — A URI reference that identifies the specific occurrence of the problem (typically the request path).
- `timestamp` (datetime, optional) — The timestamp when the error occurred.
- `request_id` (string, optional) — Correlation identifier for the request, useful for support investigations.
- `errors` (list of ValidationError, optional) — Optional list of individual validation or domain errors.

## Types

### Workflow

- `id` (string, optional) — A unique ID for this workflow
- `name` (string, optional) — A user-provided name for this workflow
- `account_id` (string, optional) — A unique ID for the account associated with the workflow
- `status` (string, optional) — Indicates the readiness and deployment status of a workflow
- `metadata` (ResourceMetadata, optional)

### ResponseMetadata

Additional server-side metadata for a given response

- `response_timestamp` (datetime, optional) — The timestamp indicating when the response was generated.
- `response_duration_ms` (integer, optional) — The duration of time, in milliseconds, that the server took to process and respond to the request. This is measured from the time the server received the request until the time the response was sent.
- `request_id` (string, optional) — Unique identifier for the request, useful for tracking and debugging.

### ValidationError

A single field-level or domain validation error.

- `code` (string, required) — Machine-readable error code.
- `message` (string, required) — Human-readable description of the error.
- `target` (string, optional) — The field or parameter this error relates to.

### ResourceMetadata

- `created_at` (datetime, optional) — Timestamp when the agreement document was created.
- `created_by` (string, optional) — User ID of the person who created the agreement document.
- `modified_at` (datetime, optional) — Timestamp when the agreement document was last modified.
- `modified_by` (string, optional) — User ID of the person who last modified the agreement document.

## Examples

**Response**

```json
{
  "data": [
    {
      "id": "9fabc6d2-748b-41c9-8d5e-5fbf2f7e6e72",
      "name": "Agreement Signature Collection",
      "account_id": "6b5a8c4e-1f93-41b5-9279-8bc2ad365dd1",
      "status": "active",
      "metadata": {
        "created_at": "2024-07-05T12:00:00+02:00",
        "created_by": "e3d89a85-c7d4-4df9-b987-78f5fc45a482"
      }
    },
    {
      "id": "b3c1ff15-4f5e-42b0-b74e-96177fa0e92d",
      "name": "Contract Review Reminder",
      "account_id": "6b5a8c4e-1f93-41b5-9279-8bc2ad365dd1",
      "status": "active",
      "metadata": {
        "created_at": "2024-06-20T15:30:00+02:00",
        "created_by": "fbd89b4f-0ecf-47b7-b3fd-59e9e1c8fd17"
      }
    },
    {
      "id": "2fe67b39-1920-46d1-b0c1-3b9236b3e3ad",
      "name": "Contract Expiration Notification",
      "account_id": "6b5a8c4e-1f93-41b5-9279-8bc2ad365dd1",
      "status": "active",
      "metadata": {
        "created_at": "2024-08-01T09:45:00+02:00",
        "created_by": "c6e8a5b3-fb1b-4c6e-a02a-267f8490731d"
      }
    },
    {
      "id": "6f0e1d91-d8e5-4c7a-a00e-8b9d4f95d5b8",
      "name": "Legal Agreement Archival",
      "account_id": "6b5a8c4e-1f93-41b5-9279-8bc2ad365dd1",
      "status": "active",
      "metadata": {
        "created_at": "2024-10-01T08:00:00+02:00",
        "created_by": "d7c94ff2-9b30-4872-9b56-e3a8f781632b"
      }
    }
  ],
  "response_metadata": {
    "response_timestamp": "2024-11-10T11:30:00+02:00",
    "response_duration_ms": 150,
    "total_items": 4
  }
}
```