{"id":4821,"date":"2026-03-30T09:06:58","date_gmt":"2026-03-30T09:06:58","guid":{"rendered":"https:\/\/tinyurl.com\/blog\/?p=4821"},"modified":"2026-04-07T15:53:44","modified_gmt":"2026-04-07T15:53:44","slug":"how-use-try-it-out-tinyurl","status":"publish","type":"post","link":"https:\/\/tinyurl.com\/blog\/how-use-try-it-out-tinyurl\/","title":{"rendered":"How to Use the \u201cTry it out\u201d Feature on the TinyURL API?"},"content":{"rendered":"\n<p style=\"font-size:16px\"><a href=\"https:\/\/tinyurl.com\/app\/dev\" target=\"_blank\" rel=\"noreferrer noopener\">TinyURL OpenAPI<\/a>&nbsp;allows API testing directly on the TinyURL API documentation page using the&nbsp;<strong>Try it out<\/strong>&nbsp;feature. This page walks through the key details on the documentation page and how to use \u201cTry it out\u201d feature with \/create endpoint to create TinyURLs.<\/p>\n\n\n\n<div style=\"height:25px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<p style=\"font-size:16px\">The following screenshot highlights the key details on the API page.<\/p>\n\n\n\n<div style=\"height:16px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<ul class=\"wp-block-list\">\n<li style=\"font-size:16px\">On the left side, we have the HTTP Request Method used for each call like POST, GET, PATCH, PUT etc.<\/li>\n<\/ul>\n\n\n\n<div style=\"height:50px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<p><img decoding=\"async\" src=\"https:\/\/malcolm-en-gb.s3.eu-west-1.amazonaws.com\/instances\/n9sEghF2ZC\/resources\/2sDQAYYPhR\/API%20-%20HTTP%20Request%20Method.png\" alt=\"API - HTTP Request Method\" width=\"75%\"><\/p>\n\n\n\n<div style=\"height:50px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<ul class=\"wp-block-list\">\n<li style=\"font-size:16px\">Right next to it is the API endpoint used for making calls to TinyURL, followed by a brief description.<\/li>\n<\/ul>\n\n\n\n<div style=\"height:50px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<p><img decoding=\"async\" src=\"https:\/\/malcolm-en-gb.s3.eu-west-1.amazonaws.com\/instances\/n9sEghF2ZC\/resources\/dwNqLFYoy7\/API%20-%20Endpoints%20and%20Descriptions.png\" alt=\"API - Endpoints and Descriptions\" width=\"75%\"><\/p>\n\n\n\n<div style=\"height:50px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<ul class=\"wp-block-list\">\n<li style=\"font-size:16px\">On the right side, we can see the lock buttons which are used to authorize the API calls made via this tool. It is possible to authorize using a single token for all endpoints (lock button in the top right) or use a specific token for each API endpoint (lock button in front of each endpoint)<\/li>\n<\/ul>\n\n\n\n<div style=\"height:25px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<p style=\"font-size:16px\">All the API endpoints can be tested without writing any code using the \u201cTry it out\u201d feature. Testing API endpoints usually requires two things:<\/p>\n\n\n\n<div style=\"height:16px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<ul class=\"wp-block-list\">\n<li style=\"font-size:16px\">Authorization Token (API Token)<\/li>\n<\/ul>\n\n\n\n<div style=\"height:16px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<ul class=\"wp-block-list\">\n<li style=\"font-size:16px\">Input parameters and Request body (if needed)<\/li>\n<\/ul>\n\n\n\n<div style=\"height:50px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<p><img decoding=\"async\" src=\"https:\/\/malcolm-en-gb.s3.eu-west-1.amazonaws.com\/instances\/n9sEghF2ZC\/resources\/6pUwy4sH3j\/API%20-%20Authorize%20button.png\" alt=\"API - Authorize button\" width=\"75%\"><\/p>\n\n\n\n<div style=\"height:50px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<p style=\"font-size:16px\">Once you click any of those buttons,a dialog box prompts you to enter your API token, which is valid for the current web session. You can enter the API token as the value for bearerAuth or tokenAuth.<\/p>\n\n\n\n<div style=\"height:50px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<p><img decoding=\"async\" width=\"75%\" src=\"https:\/\/malcolm-en-gb.s3.eu-west-1.amazonaws.com\/instances\/n9sEghF2ZC\/resources\/UJdVPfedDx\/API%20-%20bearerAuth.png\" alt=\"API - bearerAuth\"><\/p>\n\n\n\n<div style=\"height:50px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<p style=\"font-size:16px\">When you expand an endpoint listing, you see possible input parameters, request body and example server responses. Example server responses are a good way to understand the behaviour of the TinyURL API. Different response codes and error messages help you narrow down potential problems in your usage. Some parameters include a default or a list of allowed values.<\/p>\n\n\n\n<div style=\"height:25px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<p style=\"font-size:16px\">Here is a detailed guide on how to create a TinyURL using API.<\/p>\n\n\n\n<div style=\"height:16px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<ol class=\"wp-block-list\">\n<li style=\"font-size:16px\">The first step is to generate an API token with permissions for \u201c<strong>Create TinyURL<\/strong>\u201d. Please refer to \u201c<a href=\"https:\/\/tinyurl.com\/blog\/how-create-modify-api-token\/\" target=\"_blank\" rel=\"noreferrer noopener\">How to create or modify an API token with specific permissions?<\/a>\u201d if you want guidance on how to create API token with specific permissions<\/li>\n<\/ol>\n\n\n\n<div style=\"height:16px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<ol start=\"2\" class=\"wp-block-list\">\n<li style=\"font-size:16px\">Once you have created the token, please go to the TinyURL API and authenticate the browser session using the instructions given above.<\/li>\n<\/ol>\n\n\n\n<div style=\"height:16px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<ol start=\"3\" class=\"wp-block-list\">\n<li style=\"font-size:16px\">The next step is to use the Try it out feature on the API page with the&nbsp;<em>POST<\/em>&nbsp;<code>\/create<\/code>&nbsp;endpoint. Simply expand the endpoint by clicking anywhere on the&nbsp;<em>POST<\/em>&nbsp;<code>\/create<\/code>&nbsp;row and then click the&nbsp;<strong>Try it out<\/strong>&nbsp;button.<\/li>\n<\/ol>\n\n\n\n<div style=\"height:50px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<p><img decoding=\"async\" src=\"https:\/\/malcolm-en-gb.s3.eu-west-1.amazonaws.com\/instances\/n9sEghF2ZC\/resources\/h5kVGqdkzH\/API%20-%20Try%20It%20Out.png\" alt=\"API - Try It Out\" width=\"75%\"><\/p>\n\n\n\n<div style=\"height:50px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<ol start=\"4\" class=\"wp-block-list\">\n<li style=\"font-size:16px\">Once you click \u201cTry it out\u201d, the Request body below is now editable. The only field necessary for creating a TinyURL is&nbsp;<em>url<\/em>&nbsp;which is the destination URL and rest of the fields are optional. For example, the following is a valid Request Body:<\/li>\n<\/ol>\n\n\n\n<div style=\"height:16px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<pre class=\"wp-block-code\" style=\"font-size:16px\"><code>{\n\"url\": \"https:\/\/www.example.com\/my-really-long-link-that-I-need-to-shorten\/84378949\"\n}<\/code><\/pre>\n\n\n\n<div style=\"height:16px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<ol start=\"5\" class=\"wp-block-list\">\n<li style=\"font-size:16px\">Clicking \u201cExecute\u201d button with the above body should result in the following successful response from the server, which means that you have successfully created a TinyURL using the API.<\/li>\n<\/ol>\n\n\n\n<div style=\"height:16px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<ol start=\"6\" class=\"wp-block-list\">\n<li style=\"font-size:16px\">If needed, you can specify additional details such as a branded\/custom domain, custom alias, tags or expires at in the input Request body.<\/li>\n<\/ol>\n\n\n\n<div style=\"height:25px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<p style=\"font-size:16px\">Please note that \u201c<em>description<\/em>\u201d, \u201c<em>tags<\/em>\u201d and \u201c<em>expires_at<\/em>\u201d will only work with paid subscriptions. If you\u2019re using a free account, you need to remove or leave these fields blank before processing your API request. API tokens must have the appropriate permissions.<\/p>\n\n\n\n<div style=\"height:25px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<pre class=\"wp-block-code\" style=\"font-size:16px\"><code>{\n  \"url\": \"https:\/\/mybranded.link\/my-really-long-link-that-I-need-to-shorten\/84378949\",\n  \"domain\": \"tinyurl.com\",\n  \"alias\": \"enterYourCustomAliasHere\",\n  \"tags\": \"example,link\",\n  \"expires_at\": \"2028-12-30 00:00:00\",\n  \"description\": \"string\"\n}<\/code><\/pre>\n\n\n\n<p><\/p>\n","protected":false},"excerpt":{"rendered":"<p>TinyURL OpenAPI&nbsp;allows API testing directly on the TinyURL API documentation page using the&nbsp;Try it out&nbsp;feature. This page walks through the key details on the documentation page and how to use \u201cTry it out\u201d feature with \/create endpoint to create TinyURLs. The following screenshot highlights the key details on the API page. All the API endpoints [&hellip;]<\/p>\n","protected":false},"author":4,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[60],"tags":[67],"class_list":["post-4821","post","type-post","status-publish","format-standard","hentry","category-help","tag-api-help"],"_links":{"self":[{"href":"https:\/\/tinyurl.com\/blog\/wp-json\/wp\/v2\/posts\/4821","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/tinyurl.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/tinyurl.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/tinyurl.com\/blog\/wp-json\/wp\/v2\/users\/4"}],"replies":[{"embeddable":true,"href":"https:\/\/tinyurl.com\/blog\/wp-json\/wp\/v2\/comments?post=4821"}],"version-history":[{"count":5,"href":"https:\/\/tinyurl.com\/blog\/wp-json\/wp\/v2\/posts\/4821\/revisions"}],"predecessor-version":[{"id":4967,"href":"https:\/\/tinyurl.com\/blog\/wp-json\/wp\/v2\/posts\/4821\/revisions\/4967"}],"wp:attachment":[{"href":"https:\/\/tinyurl.com\/blog\/wp-json\/wp\/v2\/media?parent=4821"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/tinyurl.com\/blog\/wp-json\/wp\/v2\/categories?post=4821"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/tinyurl.com\/blog\/wp-json\/wp\/v2\/tags?post=4821"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}