---
title: "POST /experimental/schedules/skill-draft"
method: POST
path: "/experimental/schedules/skill-draft"
tags: ["Schedules"]
---

# POST /experimental/schedules/skill-draft

`POST /experimental/schedules/skill-draft`

Drafts a SKILL.md for a new loop from the loop's name and description. Nothing is published; the draft is returned for the user to edit.

## Headers

- `Authorization` string

## Request body

- object
  - `workspaceName` string, required — Workspace the loop and its skill will be created in.
  - `name` string, required
  - `description` string

## Response `200`

Default Response

- object
  - `links` object, required
    - `self` string, uri, required
  - `data` object, required
    - `id` string, uuid, required — Identifies this draft; drafts are not stored.
    - `type` 'schedule-skill-draft', required
    - `attributes` object, required
      - `skillName` string, required — Suggested skill name; lowercase letters, digits, and single hyphens.
      - `skillMd` string, required — Complete SKILL.md, including its frontmatter.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Default Response
- `404` — Not Found
- `429` — Too Many Requests
- `500` — Internal Server Error
- `502` — Bad Gateway
- `504` — Gateway Timeout

## Changes

- **2026-09-30** `be5a1bbf9bfa` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/tessl/apis/tessl-api/changes/experimental/schedules/skill-draft/post.md)

---

[API](https://skmtc.dev/tessl/apis/tessl-api.md) · [All operations](https://skmtc.dev/tessl/apis/tessl-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tessl/apis/tessl-api/revisions/ea9739cd90bc?raw)