---
title: "Unpublish a script to make it unavailable for new executions."
method: POST
path: "/api/v1/script/{script}/unpublish"
---

# Unpublish a script to make it unavailable for new executions.

`POST /api/v1/script/{script}/unpublish`

**Authentication**: JWT token required
**Authorization**: Admin or script owner access required
**Purpose**: Removes a published script from public availability while
  preserving data

**Path Parameters**:
- `script`: Script identifier/slug or numeric ID

**Request**: No request body required

**Success Response Schema**:
```json
{
  "data": {
    "id": "script-123",
    "slug": "vegetation-analysis",
    "name": "Vegetation Change Analysis",
    "description": "Analyzes vegetation changes using satellite imagery",
    "status": "UNPUBLISHED",
    "created_at": "2025-01-15T10:30:00Z",
    "updated_at": "2025-01-15T10:35:00Z",
    "user_id": "user-456",
    "cpu": 2,
    "memory": 4096,
    "logs": false
  }
}
```

**Unpublishing Effects**:
- Updates script status from PUBLISHED to UNPUBLISHED
- Removes script from public script listings
- Prevents new executions from being started
- Existing running executions continue to completion
- Script data and configuration are preserved

**Use Cases**:
- Temporarily disable a script for maintenance
- Remove deprecated or problematic scripts
- Control script availability during updates

**Error Responses**:
- `401 Unauthorized`: JWT token required
- `403 Forbidden`: Insufficient permissions to unpublish script
- `404 Not Found`: Script does not exist
- `400 Bad Request`: Script not in valid state for unpublishing
- `500 Internal Server Error`: Unpublishing failed

## Path parameters

- `script` string, required

## Request body

- object

## Response `200`

Success

- object

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `500` — Internal Server Error

---

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