👋 Hey everyone! Wondering why Shortiny is completely free? No catch, we promise! We're passionate about making top-quality URL shortening accessible to all. Rest assured, existing users will keep enjoying all features for free. If we ever introduce paid plans in the future, it will only apply to new users. Spread the word and invite your friends to grab their free accounts now! 🚀

Spaces

Notes
Expert level
The API key should be sent as a Bearer token in the Authorization header of the request. Get your API key.
List

API endpoint:

GET 
https://shortiny.com/api/v1/spaces

Request example: 

curl --location --request GET 'https://shortiny.com/api/v1/spaces' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {api_key}'
Parameter
Type
Description
search
optional string
The search query.
search_by
optional string
Search by. Possible values are: name for Name. Defaults to: name.
sort_by
optional string
Sort by. Possible values are: id for Date created, name for Name. Defaults to: id.
sort
optional string
Sort. Possible values are: desc for Descending, asc for Ascending. Defaults to: desc.
per_page
optional integer
Results per page. Possible values are: 10, 25, 50, 100. Defaults to: 25.
Show

API endpoint:

GET 
https://shortiny.com/api/v1/spaces/{id}

Request example: 

curl --location --request GET 'https://shortiny.com/api/v1/spaces/{id}' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {api_key}'
Store

API endpoint:

POST 
https://shortiny.com/api/v1/spaces

Request example: 

curl --location --request POST 'https://shortiny.com/api/v1/spaces' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'Authorization: Bearer {api_key}' \
--data-urlencode 'name={name}'
Parameter
Type
Description
name
required string
The space name.
color
optional integer
The color code. Possible values are: 1, 2, 3, 4, 5, 6. Defaults to: 1.
Update

API endpoint:

PUT PATCH 
https://shortiny.com/api/v1/spaces/{id}

Request example: 

curl --location --request PUT 'https://shortiny.com/api/v1/spaces/{id}' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'Authorization: Bearer {api_key}'
Parameter
Type
Description
name
optional string
The space name.
color
optional integer
The color code. Possible values are: 1, 2, 3, 4, 5, 6.
Delete

API endpoint:

DELETE 
https://shortiny.com/api/v1/spaces/{id}

Request example: 

curl --location --request DELETE 'https://shortiny.com/api/v1/spaces/{id}' \
--header 'Authorization: Bearer {api_key}'