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 new link or continues an existing one. The Wisy agent reads the message, builds a hosted page, and reports back. Privacy and page meta are resolved by the agent — no explicit type or settings fields in the request.

Request:

Notes:

• Omit id to start a fresh link; the build begins immediately and status is building until it settles.
• Include id to continue generation on an existing link. The server tracks conversation history — send only the new message.
• file_ids references uploaded files. Use Create File and Upload File first, then pass the returned id values.
• url is the hosted page URL; it goes live once the build finishes (status becomes completed).

Request example:

# New link
curl -X POST "https://wisylink.com/api/chat" \
  -H "x-api-key: <api_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "Create a short product trailer with energetic pacing.",
    "file_ids": ["abc123"]
  }'

Response (201 for new link, 200 for continued link):

{
  "id": "abc123",
  "url": "https://abc123.wisylink.com",
  "status": "building",
  "answer": "On it — building your product trailer now.",
  "created_at": 1762432496000,
  "updated_at": 1762432496000
}

Returns your links, newest first, with page-based pagination.

Request:

Request example:

curl "https://wisylink.com/api/links?page=1&limit=20" \
  -H "x-api-key: <api_key>"

Response (200):

{
  "items": [
    {
      "id": "abc123",
      "url": "https://abc123.wisylink.com",
      "status": "completed",
      "file_ids": ["67e6f6e6c5a91e4d2d9b0a11"],
      "created_at": 1762432496000,
      "updated_at": 1762432596000
    }
  ],
  "page": 1,
  "limit": 20,
  "total": 1,
  "total_pages": 1,
  "has_prev": false,
  "has_next": false
}

Returns a single link by id with its hosted-page URL and metadata.

Request:

Notes:

• url is the hosted page URL.
• file_ids lists the reference files attached to the link.

Request example:

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

Response (200):

{
  "id": "abc123",
  "url": "https://abc123.wisylink.com",
  "status": "completed",
  "file_ids": ["67e6f6e6c5a91e4d2d9b0a11"],
  "created_at": 1762432496000,
  "updated_at": 1762432596000
}

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/abc123" \
  -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 by POST /links when the account's API credit balance is empty and can't cover a new build.

{
  "error": "insufficient_credit",
  "message": "You're out of API credits right now — top up your balance and I'll pick this right back up."
}

Returned on any endpoint when the API key's spend for the current period reaches its credit limit. limit, used, and remaining are USD; resets_at is epoch milliseconds.

{
  "error": "credit_limit_exceeded",
  "message": "API key credit limit is exceeded for the current period.",
  "limit": 50,
  "used": 50,
  "remaining": 0,
  "period": "month",
  "resets_at": 1762432496000
}

Returned by POST /links when too many builds are already running for the plan. Wait for one to finish, then retry. limit is the concurrent-build allowance.

{
  "error": "build_concurrency_limit",
  "message": "Too many builds running at once for your plan. Wait for one to finish.",
  "limit": 1
}

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.