Endpoints

All endpoints are relative to the base URL https://api.visihub.com/v1. All requests require authentication unless noted otherwise.

Files

GET /files

Returns a paginated list of files owned by the authenticated user.

Query parameters:

Parameter	Type	Description
`page`	integer	Page number (default: 1)
`per_page`	integer	Results per page (default: 25, max: 100)

GET /files/:id

Returns metadata for a single file.

POST /files

Upload a new spreadsheet file. Use multipart/form-data encoding.

Parameters:

Parameter	Type	Description
`file`	file	The spreadsheet file (`.sheet`, `.csv`, `.xlsx`)
`name`	string	Display name (optional, defaults to filename)
`visibility`	string	`private` or `public` (default: `private`)

PATCH /files/:id

Update file metadata.

Body parameters:

Parameter	Type	Description
`name`	string	New display name
`visibility`	string	`private` or `public`

DELETE /files/:id

Move a file to trash. Files in trash are permanently deleted after 30 days.

GET /files/:id/download

Returns the file contents with appropriate Content-Type and Content-Disposition headers.

GET /users/me

Returns the authenticated user’s profile.

PATCH /users/me

Body parameters:

Parameter	Type	Description
`name`	string	Display name

POST /sessions

Sends a magic link to the provided email address. Does not require authentication.

Body parameters:

Parameter	Type	Description
`email`	string	Email address

POST /sessions/verify

Exchanges a magic link token for a JWT. Does not require authentication.

Body parameters:

Parameter	Type	Description
`token`	string	Token from the magic link

Response:

{
  "jwt": "eyJhbGciOi...",
  "user": {
    "id": "user_abc123",
    "email": "user@example.com",
    "name": "Jane Doe"
  }
}

DELETE /sessions

Revokes the current JWT token.