---
title: "Install Expert Workflow"
method: POST
path: "/api/experts/{expert_id}/workflows"
tags: ["v2", "experts", "experts", "private"]
---

# Install Expert Workflow

`POST /api/experts/{expert_id}/workflows`

## Path parameters

- `expert_id` string, required

## Request body

- InstallWorkflowRequest — One workflow source: a marketplace listing, or the caller's own agent.
  - `store_listing_version_id` string, nullable
  - `library_agent_id` string, nullable

## Response `200`

Successful Response

- ExpertWorkflowRef
  - `id` string, required
  - `store_listing_version_id` string, nullable, required
  - `library_agent_id` string, nullable, required
  - `graph_id` string, nullable, required
  - `name` string, nullable, required
  - `description` string, nullable, required
  - `schedule_cron` string, nullable
  - `schedule_id` string, nullable
  - `chain` ExpertWorkflowChainItem[]
    - `kind` 'integration' | 'input' | 'output' | 'trigger' | 'agent' | 'ai' | 'mcp' | 'human', required
    - `provider` string, nullable
  - `integration_providers` string[]

## Other responses

- `401` — Authentication required
- `404` — Expert or workflow not found
- `422` — Validation Error

## Changes

- **2026-09-11** `55ff31eb7c7f` — 1 info
  - added the optional property `integration_providers` to the response with the `200` status
- **2026-09-07** `d3946c727d24` — 1 info
  - added the optional property `chain` to the response with the `200` status
- **2026-09-03** `c82c9e00155e` — 3 info
  - added the new optional request property `library_agent_id`
  - the request property `store_listing_version_id` became optional
  - request property `store_listing_version_id` list-of-types was widened by adding types `null` to media type `application/json`
- **2026-08-06** `3dfd3128358f` — 2 info
  - added the optional property `schedule_cron` to the response with the `200` status
  - added the optional property `schedule_id` to the response with the `200` status
- **2026-07-29** `e7a8c399e03e` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/significant-gravitas/apis/autogpt-agent-server/changes/api/experts/:expert_id/workflows/post.md)

---

[API](https://skmtc.dev/significant-gravitas/apis/autogpt-agent-server.md) · [All operations](https://skmtc.dev/significant-gravitas/apis/autogpt-agent-server/llms.txt) · [OpenAPI document](https://skmtc.dev/significant-gravitas/apis/autogpt-agent-server/revisions/5f27fa9d6c03?raw)