Oops! Facing network problem. Unable to load this page. Refresh

Please Wait...

Hello Guest

logo

Move URLs To Folder

Move URLs To Folder api document


APIs

Move URLs To Folder

Getting Started

Authenticate using the Login API to obtain an access token. Include the returned Bearer Token in the Authorization header and provide a unique X-Device-ID with all authenticated requests. All requests must be made over HTTPS and are subject to rate limits.

Base URL: https://insprl.com/api

POST /external/folder/move
Use the List Folders API to retrieve folders associated with your SPRL account. This endpoint allows integrations to display, manage, and organize short URLs into folders directly from browser extensions, WordPress plugins, automation platforms, mobile applications, and custom software.

Request Information

MethodPOST
API Endpointhttps://insprl.com/api/external/folder/move
Authentication Required

Header Parameters

ParameterTypeDescription
AuthorizationStringBearer authentication token received from the Login API.
X-Device-IDStringThe same device identifier used during login.
Content-TypeJSONapplication/json

Request Parameters

ParameterTypeValidateDescription
slugsArrayRequiredList of URL slugs to move.
folder_flagStringRequiredDestination folder identifier.

Response Parameters

ParameterTypeDescription
successBooleanRequest status (true/false).
moved_countIntegerTotal URLs moved successfully.
messageStringStatus message returned by the API.

Response Codes

SPRL Code HTTP Status Mode Response Field Description
100 200 success data Request processed successfully.
101 401 failed message Authentication failed. Invalid session, token or credentials.
102 422 failed errors Parameter validation failed. Check the request fields.
103 404 failed message Requested resource was not found.
104 403 failed message Access denied or account restricted.
105 429 failed message Too many requests. Please retry later.
106 500 failed message Unexpected server error. Please try again later.

Error Flag Reference

Category Flag Type Description
Authentication INVALID_SESSION auth_error The supplied token or device identifier is invalid.
Authentication INVALID_CREDENTIALS auth_error Invalid login credentials supplied.
Validation INVALID_PARAMETER validation_error One or more request parameters are invalid.
Resource RESOURCE_NOT_FOUND resource_error The requested URL, folder, domain or resource could not be found.
Account ACCOUNT_RESTRICTED account_error The account is restricted or access has been denied.
Rate Limit RATE_LIMIT_EXCEEDED rate_limit_exceeded The request rate limit has been exceeded.
Server UNEXPECTED_ERROR server_error An unexpected internal server error occurred.

Notes:

  • Only URLs belonging to the authenticated SPRL account can be moved.
  • The destination folder must belong to the authenticated account.
  • The special folders my-urls and api-urls can be used to remove folder assignment.
  • The same X-Device-ID used during login must be supplied.
  • Authentication is required for all requests to this endpoint.
99.9% Uptime
High Availability Infrastructure
Enterprise Security
OWASP-Aligned Controls
Built for Scale
High-Performance REST APIs

Security & Compliance

We follow industry best practices for API security and data protection.

Our APIs are designed with authentication, rate limiting, and continuous security review.

View our Security & Compliance Overview (PDF)
sprl chrome extension

Download the SPRL Google Chrome extension, It's free!

Easy and Quick way to shorten link with SPRL!

 Download Extension

We provide best customer support.

Please feel free to contact us at 8088 948 172 for support.

Contact Us
×

We use cookies to improve your experience, analyse traffic, and personalise content. By clicking “Accept”, you consent to the use of cookies as described in our Cookie Policy .

Accept cookies Read our Cookie Policy