WisyLink API

Starts a new file upload session and returns the file id to use in chunk uploads.

Request:

Request example:

curl -X POST "https://wisylink.com/api/files" \
  -H "x-api-key: <api_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "my-original-video.mov"
  }'

Response (201):

{
  "id": "67e6f6e6c5a91e4d2d9b0a11",
  "created_at": 1762432496000
}

Uploads raw file chunks to an existing file id. Each request accepts at most 4 MB.

Request:

Request example:

curl -X POST "https://wisylink.com/api/files/chunks?id=<file_id>&last=true" \
  -H "x-api-key: <api_key>" \
  -H "Content-Type: application/octet-stream" \
  --data-binary "@./chunk-last.bin"

Response (200):

{
  "id": "67e6f6e6c5a91e4d2d9b0a11",
  "ok": true
}

Notes:

• Upload sessions expire automatically if not completed within 15 minutes.
• The final chunk must be sent with last=true; that call finalizes and processes the file.

Returns metadata for a single uploaded file by id.

Request:

Request example:

curl "https://wisylink.com/api/files/67e6f6e6c5a91e4d2d9b0a11" \
  -H "x-api-key: <api_key>"

Response (200):

{
  "id": "67e6f6e6c5a91e4d2d9b0a11",
  "content_type": "video/mp4",
  "name": "my-original-video.mp4",
  "size": 128934,
  "created_at": 1762432496000,
  "updated_at": 1762432496000
}

Permanently removes a single uploaded file and its stored object. References to this file id in any link file_ids are removed automatically.

Request:

Request example:

curl -X DELETE "https://wisylink.com/api/files/67e6f6e6c5a91e4d2d9b0a11" \
  -H "x-api-key: <api_key>"

Response (200):

{ "ok": true }

Creates a single link with generation input and optional attached files.

Request:

Notes:

• file_ids references uploaded files. Use Create File and Upload File first, then pass the returned file id values (id field).
• private: true adds stricter crawler-discovery blocking intent for the link surface.
• shared_url is generated from the apex domain + link id (extensionless path).
• New links are created with status: pending internally.

Request example:

curl -X POST "https://wisylink.com/api/links" \
  -H "x-api-key: <api_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "video",
    "prompt": "Create a short product trailer with energetic pacing.",
    "hosted": true,
    "file_ids": ["67e6f6e6c5a91e4d2d9b0a11", "67e6f6e6c5a91e4d2d9b0a22"]
  }'

Response (201):

{
  "id": "67e6f6e6c5a91e4d2d9b0a77",
  "shared_url": "https://wisylink.com/67e6f6e6c5a91e4d2d9b0a77",
  "status": "pending",
  "created_at": 1762432496000,
  "updated_at": 1762432496000
}

Returns a single link by id with current status and shared URL.

Request:

Notes:

• meta is present in the response only when status is completed.
• meta.duration (seconds) is included only when type is audio or video.

Request example:

curl "https://wisylink.com/api/links/67e6f6e6c5a91e4d2d9b0a77" \
  -H "x-api-key: <api_key>"

Response (200):

{
  "id": "67e6f6e6c5a91e4d2d9b0a77",
  "type": "video",
  "prompt": "Create a short product trailer with energetic pacing.",
  "hosted": true,
  "status": "completed",
  "meta": {
    "title": "Product Trailer — Energetic Pacing",
    "description": "A punchy 10-second trailer showcasing the product with energetic cuts and momentum.",
    "cover": "cover.jpg",
    "duration": 10
  },
  "outputs": ["output-1.mp4"],
  "file_ids": ["67e6f6e6c5a91e4d2d9b0a11"],
  "created_at": 1762432496000,
  "updated_at": 1762432596000,
  "shared_url": "https://wisylink.com/67e6f6e6c5a91e4d2d9b0a77"
}

Updates a single existing link by id using mutable fields (prompt, hosted, private, file_ids).

Request:

Rules:

• At least one updatable field must be present in request body.
• If file_ids is provided, it fully replaces the existing attachment list.
• To keep older file ids, include them again in the same update request.
• File ids removed from the list are deleted with their related asset records.
• If prompt changes, regeneration is auto-queued and update credit is consumed. Changes to file_ids, hosted, or private alone do not trigger regeneration.
• Hosted links cost 1 credit/day; hosted + private links cost 2 credits/day.

Request example:

curl -X PATCH "https://wisylink.com/api/links/67e6f6e6c5a91e4d2d9b0a77" \
  -H "x-api-key: <api_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Create a 20-second trailer, emphasize motion graphics.",
    "file_ids": ["67e6f6e6c5a91e4d2d9b0a22"],
    "hosted": true
  }'

Response (200):

Same fields as Get Link response.

{
  "id": "67e6f6e6c5a91e4d2d9b0a77",
  "type": "video",
  "prompt": "Create a 20-second trailer, emphasize motion graphics.",
  "hosted": true,
  "status": "pending",
  "outputs": ["output-1.mp4"],
  "file_ids": ["67e6f6e6c5a91e4d2d9b0a22"],
  "created_at": 1762432496000,
  "updated_at": 1762432696000,
  "shared_url": "https://wisylink.com/67e6f6e6c5a91e4d2d9b0a77"
}

Permanently removes a single link by id. Files listed in the link file_ids are deleted together (file record + stored object).

Request:

Request example:

curl -X DELETE "https://wisylink.com/api/links/67e6f6e6c5a91e4d2d9b0a77" \
  -H "x-api-key: <api_key>"

Response (200):

{ "ok": true }

Returned when API key is missing or invalid.

{
  "error": "unauthorized",
  "message": "Missing or invalid API key. Provide `x-api-key` or `Authorization: Bearer <key>`."
}

Returned when API key usage exceeds credit limit for the active period.

{
  "error": "credit_limit_exceeded",
  "message": "API key credit limit is exceeded for the current period.",
  "limit": 100,
  "used": 100,
  "remaining": 0,
  "period": "day",
  "resets_at": 1762473600000
}

Returned for invalid request shape, invalid types, invalid formats, or missing required values.

Returned when target file or link does not exist for the authenticated owner.