remove-password-from-pdf

# remove-password-from-pdf

## Purpose
This skill removes password protection from a PDF by:
1) accepting a password-protected PDF from the user,
2) accepting the current password from the user,
3) uploading both to the Solutions API,
4) polling the job status until it is finished,
5) returning the download URL for the unlocked PDF.

## Credentials
The API requires an API key used as a Bearer token:
- `Authorization: Bearer <API_KEY>`

How the user gets an API key:
- https://login.cross-service-solutions.com/register
- Or the user can provide an API key directly.

**Rule:** never echo or log the API key.

## API endpoints
Base URL:
- `https://api.xss-cross-service-solutions.com/solutions/solutions`

Create remove-password job:
- `POST /api/33`
- `multipart/form-data` parameters:
  - `file` (PDF-Datei) — required — PDF file
  - `password` (Password) — required — string (current password to unlock)

Get result by ID:
- `GET /api/<ID>`

When done, the response contains:
- `output.files[]` with `{ name, path }` where `path` is a downloadable URL.

## Inputs
### Required
- PDF file (binary)
- Current password (`password`, string)
- API key (string)

### Optional
- None

## Output
Return a structured result:
- `job_id` (number)
- `status` (string)
- `download_url` (string, when done)
- `file_name` (string, when available)

Example output:
```json
{
  "job_id": 654,
  "status": "done",
  "download_url": "https://.../unlocked.pdf",
  "file_name": "unlocked.pdf"
}

---

## `README.md`

```md
# remove-password-from-pdf (OpenClaw Skill)

Remove password protection from a PDF using the Solutions API and return a download URL for the unlocked file.

## What you need
- A password-protected PDF file
- The current password (used as `password`)
- A Solutions API key (Bearer token)
  - Register / get key: https://login.cross-service-solutions.com/register

## How it works
1) Upload PDF + current password to:
   `POST https://api.xss-cross-service-solutions.com/solutions/solutions/api/33`
2) Poll:
   `GET  https://api.xss-cross-service-solutions.com/solutions/solutions/api/<job_id>`
3) Return `output.files[0].path` as the download URL

## Script (CLI)
```bash
python scripts/remove_password_from_pdf.py \
  --pdf "/path/to/protected.pdf" \
  --password "CurrentPasswordHere" \
  --api-key "$SOLUTIONS_API_KEY"