---
title: "Optimize Agent Skill Text"
method: POST
path: "/v1/interview-agents/skills/optimize"
tags: ["interview-agents"]
---

# Optimize Agent Skill Text

`POST /v1/interview-agents/skills/optimize`

## Request body

- AgentSkillOptimizeIn
  - `workspace_id` string, uuid, required
  - `field` 'description' | 'instructions', required
  - `content` string, required
  - `name` string, nullable
  - `description` string, nullable
  - `instructions` string, nullable

## Response `200`

Successful Response

- AgentSkillOptimizeOut
  - `text` string, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/ontora/apis/ontora-api.md) · [All operations](https://skmtc.dev/ontora/apis/ontora-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ontora/ontora-api/revisions/7f57037fd94b/schema)