---
title: "Set host readme"
method: PUT
path: "/api/scripts/{handle}/{host}/readme"
---

# Set host readme

`PUT /api/scripts/{handle}/{host}/readme`

## Request

- Base URL: `https://reduck.ai`
- URL: `https://reduck.ai/api/scripts/{handle}/{host}/readme`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

Write the README for a host, the guidance shared across every script that owner has for the site. Calling it again replaces the previous text. The owner can, and so can a project member allowed to update its scripts.

## Path parameters

- `handle` string, required: The owner a resource is addressed under: "@username" for a personal scope, or a bare slug for a project.
- `host` string, required: The site the script automates, as a hostname.

## Request body

- object
  - `content` string, required

## Response `200`

OK

- HostReadme
  - `host` string, required
  - `content` string, required
  - `created_at` string, required
  - `updated_at` string, required

## Other responses

- `400`: Invalid request
- `401`: Not authenticated
- `403`: Forbidden
- `404`: Not found

---

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