---
title: "Create Workspace Usecase"
method: POST
path: "/api/workspaces/{workspace_id}/usecases"
---

# Create Workspace Usecase

`POST /api/workspaces/{workspace_id}/usecases`

## Path parameters

- `workspace_id` string, required

## Request body

- UseCaseWriteRequest
  - `name` string, required
  - `selectedKnowledgeBaseId` string, nullable
  - `description` string, nullable
  - `industry` string, nullable
  - `prompt` string, nullable
  - `useCaseGoals` string, nullable
  - `conclusion` string, nullable
  - `type` 'OUTBOUND' | 'INBOUND' | 'ONE_WAY'
  - `agentId` string, nullable
  - `escalationEnabled` boolean
  - `maxAttempts` integer, nullable
  - `escalationWindowDays` integer, nullable
  - `callsPerWeek` integer, nullable
  - `escalationUseCaseId` string, nullable
  - `phoneNumber` string, nullable
  - `inboundNumber` string, nullable
  - `enableManagerTransfer` boolean
  - `scheduleEnabled` boolean
  - `callbackTasksEnabled` boolean
  - `scheduledCallRetryDelayHours` integer
  - `scheduledCallMaxRetryAttempts` integer
  - `startTime` string
  - `endTime` string
  - `integrations` string[]
  - `taskTypes` string[]
  - `concurrency` integer
  - `defaultTtsLanguage` string
  - `defaultTtsVoice` string
  - `defaultTtsPace` number
  - `defaultTtsPitch` number
  - `promptAiSessionId` string, nullable
  - `tasksSchedulerConfig` object, nullable
  - `humanAgents` UseCaseHumanAgentWriteRequest[], nullable
    - `name` string, required
    - `phone` string, required

## Response `201`

Successful Response

- UseCaseEnvelopeResponse

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/outcallerai/apis/fastapi.md) · [All operations](https://skmtc.net/outcallerai/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/outcallerai/fastapi/revisions/a57f684e7966/schema)