# Space API ## Description This is version `1.0-beta.15` of this API documentation. Last update on Oct 17, 2025. - [API](https://call.xap3y.space) - [GitHub Repository](https://github.com/xap3y/space-api) ## Servers - https://call.xap3y.space/v1: https://call.xap3y.space/v1 () ## Authentication The API accepts 4 different authentication methods: - Verify cookie auth (http_api_key) & New email cookie (http_api_key) - Verify cookie auth (http_api_key) - Session cookie auth (http_api_key) - Api key auth (http_api_key) ## Endpoints and operations ### [Image](https://docs.xap3y.space/group/endpoint-image.md) - [Upload a ZIP archive of images](https://docs.xap3y.space/operation/operation-post-image-upload-zip.md) - [Register an image record (metadata only)](https://docs.xap3y.space/operation/operation-post-image-register.md) - [Generate a presigned PUT URL for direct upload](https://docs.xap3y.space/operation/operation-post-image-generate-upload-url.md) - [Upload image directly to cloud storage (S3-compatible)](https://docs.xap3y.space/operation/operation-post-image-upload-cloud.md) - [Upload an image](https://docs.xap3y.space/operation/operation-post-image-upload.md) - [Get image metadata by unique ID](https://docs.xap3y.space/operation/operation-get-image-info-parameter.md) - [Get an image or its base64 by unique ID](https://docs.xap3y.space/operation/operation-get-image-get-parameter.md) - [Get protected image info/data (with password or API key)](https://docs.xap3y.space/operation/operation-post-image-get-parameter.md) - [Delete an image by unique ID](https://docs.xap3y.space/operation/operation-delete-image-get-parameter.md) - [Get image/video poster thumbnail](https://docs.xap3y.space/operation/operation-get-image-get-poster-parameter.md) - [Stream video with Range support](https://docs.xap3y.space/operation/operation-get-image-get-video-parameter.md) - [Get aggregated image stats](https://docs.xap3y.space/operation/operation-get-image-stats.md) ### [ImagePlaylist](https://docs.xap3y.space/group/endpoint-imageplaylist.md) - [Get image playlist by identifier](https://docs.xap3y.space/operation/operation-get-image-playlist-get-parameter.md) - [Add images to playlist](https://docs.xap3y.space/operation/operation-put-image-playlist-get-parameter-images.md) - [Remove image from playlist](https://docs.xap3y.space/operation/operation-delete-image-playlist-get-parameter-images-parameter.md) ### [Paste](https://docs.xap3y.space/group/endpoint-paste.md) - [Create a paste (multipart or JSON)](https://docs.xap3y.space/operation/operation-post-paste-create.md) - [Get a paste by unique ID](https://docs.xap3y.space/operation/operation-get-paste-get-parameter.md) - [Delete a paste by unique ID](https://docs.xap3y.space/operation/operation-delete-paste-get-parameter.md) - [Get aggregate paste statistics](https://docs.xap3y.space/operation/operation-get-paste-stats.md) ### [Url](https://docs.xap3y.space/group/endpoint-url.md) - [Create a shortened URL](https://docs.xap3y.space/operation/operation-post-url-create.md) - [Redirect to the original URL](https://docs.xap3y.space/operation/operation-get-url-r-parameter.md) - [Get a shortened URL by unique ID](https://docs.xap3y.space/operation/operation-get-url-get-parameter.md) - [Delete a shortened URL by unique ID](https://docs.xap3y.space/operation/operation-delete-url-get-parameter.md) - [Get visit logs for a shortened URL](https://docs.xap3y.space/operation/operation-get-url-get-parameter-logs.md) ### [Auth](https://docs.xap3y.space/group/endpoint-auth.md) - [Get current user via session cookie](https://docs.xap3y.space/operation/operation-get-auth-me.md) - [Validate API key](https://docs.xap3y.space/operation/operation-get-auth-validate.md) - [Login with email and password](https://docs.xap3y.space/operation/operation-post-auth-login.md) - [Logout and invalidate session](https://docs.xap3y.space/operation/operation-post-auth-logout.md) - [Get Telegram verification data (uses verify_token cookie)](https://docs.xap3y.space/operation/operation-post-auth-verify-telegram.md) - [Validate verify token state](https://docs.xap3y.space/operation/operation-post-auth-verify-validate.md) - [Resend verification email (requires verify_token and new_email cookies)](https://docs.xap3y.space/operation/operation-post-auth-verify-resendemail.md) - [Send verification email](https://docs.xap3y.space/operation/operation-post-auth-verify-sendemail.md) - [Verify email code](https://docs.xap3y.space/operation/operation-post-auth-verify-email.md) - [Verify e-mail token via code (HTML response)](https://docs.xap3y.space/operation/operation-get-auth-verify-token.md) - [Register a new user (DEV only)](https://docs.xap3y.space/operation/operation-post-auth-register.md) ### [User](https://docs.xap3y.space/group/endpoint-user.md) - [Create user (DEV only)](https://docs.xap3y.space/operation/operation-post-user-create.md) - [Update user's social links](https://docs.xap3y.space/operation/operation-patch-user-me-socials.md) - [Get current user profile](https://docs.xap3y.space/operation/operation-get-user-get-me.md) - [Delete current user](https://docs.xap3y.space/operation/operation-delete-user-get-me.md) - [Get current user's webhook settings](https://docs.xap3y.space/operation/operation-get-user-get-me-settings-webhook.md) - [Update current user's webhook settings](https://docs.xap3y.space/operation/operation-patch-user-get-me-settings-webhook.md) - [Get current user's URL preferences](https://docs.xap3y.space/operation/operation-get-user-get-me-settings-url.md) - [Update current user's URL preferences](https://docs.xap3y.space/operation/operation-patch-user-get-me-settings-url.md) - [Get user by username, email, or ID](https://docs.xap3y.space/operation/operation-get-user-get-parameter.md) ### [Stats](https://docs.xap3y.space/group/endpoint-stats.md) - [Get total stats for all segments in range](https://docs.xap3y.space/operation/operation-post-stats-get.md) - [Get per-day stats for current user](https://docs.xap3y.space/operation/operation-post-stats-all.md) ### [Email](https://docs.xap3y.space/group/endpoint-email.md) - [Send an email (service-to-service)](https://docs.xap3y.space/operation/operation-post-email-send.md) - [Get missing inbound emails for a temp mailbox](https://docs.xap3y.space/operation/operation-post-email-getmissing.md) - [Inbound email webhook](https://docs.xap3y.space/operation/operation-post-email-inbound.md) - [Create a temporary email address](https://docs.xap3y.space/operation/operation-post-email-create.md) ### [Discord](https://docs.xap3y.space/group/endpoint-discord.md) - [Get my Discord connection](https://docs.xap3y.space/operation/operation-get-discord-get-me.md) - [Deauthorize my Discord connection](https://docs.xap3y.space/operation/operation-delete-discord-get-me.md) - [Get Discord connection by Discord ID](https://docs.xap3y.space/operation/operation-get-discord-get-parameter.md) - [Revoke a Discord auth token](https://docs.xap3y.space/operation/operation-delete-discord-token-parameter.md) - [Authorize Discord connection](https://docs.xap3y.space/operation/operation-post-discord-authorize.md) - [Login via Discord access token (sets session cookie)](https://docs.xap3y.space/operation/operation-post-discord-login.md) ### [AdminUser](https://docs.xap3y.space/group/endpoint-adminuser.md) - [Get images by user (admin)](https://docs.xap3y.space/operation/operation-get-admin-user-parameter-images.md) - [Get pastes by user (admin)](https://docs.xap3y.space/operation/operation-get-admin-user-parameter-pastes.md) - [Get short URLs by user (admin)](https://docs.xap3y.space/operation/operation-get-admin-user-parameter-urls.md) ### [AdminImage](https://docs.xap3y.space/group/endpoint-adminimage.md) - [Get image (admin, placeholder)](https://docs.xap3y.space/operation/operation-get-admin-image-get-parameter.md) ### [AdminInvite](https://docs.xap3y.space/group/endpoint-admininvite.md) - [Create invite codes (admin)](https://docs.xap3y.space/operation/operation-post-admin-invite-create.md) ### [Basic](https://docs.xap3y.space/group/endpoint-basic.md) - [Root service status](https://docs.xap3y.space/operation/operation-get-.md) - [Service status (alias)](https://docs.xap3y.space/operation/operation-get-status.md) - [Host-based redirect](https://docs.xap3y.space/operation/operation-get-r-parameter.md) ### [Web](https://docs.xap3y.space/group/endpoint-web.md) - [Image upload page](https://docs.xap3y.space/operation/operation-get-web-image-upload.md) - [Render image page](https://docs.xap3y.space/operation/operation-get-web-image-render-parameter.md) - [Render image default page](https://docs.xap3y.space/operation/operation-get-web-image-render.md) - [Create paste page](https://docs.xap3y.space/operation/operation-get-web-paste-create.md) - [Create URL page](https://docs.xap3y.space/operation/operation-get-web-url-create.md) - [Render paste page](https://docs.xap3y.space/operation/operation-get-web-paste-render-parameter.md) - [Render short URL page](https://docs.xap3y.space/operation/operation-get-web-url-render-parameter.md) [Powered by Bump.sh](https://bump.sh)