Gotipath Docs
Stream
  • Documention
  • API Reference
CDN
  • Documention
  • API Reference
Stream
  • Documention
  • API Reference
CDN
  • Documention
  • API Reference
  1. Purge
  • Distribution
    • Delete CDN Distribution
      DELETE
    • Create CDN Distribution
      POST
    • Update CDN Distribution
      PUT
    • Get All CDN Distributions
      GET
    • Get Distribution
      GET
    • Distribution Verify
      POST
  • Headers
    • Response headers
      POST
    • Create Headers
      POST
    • Request Headers
      POST
    • List
      GET
  • origin
    • Get All Origins
      GET
    • Create Origins
      POST
    • Origin Batch update
      POST
    • Update Origins
      PUT
    • Delete Origins
      DELETE
  • SSL Certificates
    • Attach Certificate to Distribution
      PUT
    • Delete Certificate
      DELETE
    • Get All Certificates
      GET
    • Create Certificate
      POST
    • Revoke Certificate from Distribution
      DELETE
  • Let's Encrypt
    • Let's Encrypt Certificate
      POST
    • Request Let's Encrypt Certificate for Distribution
      POST
  • Cache Controls
    • Create Cache Control
      POST
    • Update Cache Control
      PUT
    • Delete Cache Rules
      DELETE
    • Get Cache Control
      GET
    • Get All Cache Conrols
      GET
  • Access Controls
    • Create Access Control
    • Update Access Control
    • Delete Access Control
    • Token Reset
    • Get All Access Controls
    • Details
  • Prefetch
    • Create Prefetch
  • Purge
    • Purge
      POST
  • usages
    • Volume usage
    • Volume usage Copy
  • Traffic Usage
    • Get Bandwidth Usage
    • Get Volume Usage
    • Get Request Number Usage
  1. Purge

Purge

Developing
POST
https://apistream.gotipath.com/v1/distributions/292e5d7f-a8b9-41a0-bdf0-e70347709c6f/purges
purge
Last modified:2023-09-19 14:46:20
Maintainer:Not configured
Purge deletes cache from CDN servers. It is necessary for updating CDN content. API calls related to purging are rate and size limited. See Purge Calls Limiting for details.

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Header Params
X-Auth-ClientId
string 
required
Default:
ebe8bac0-eaef-4548-8b59-96c9ec38a22b
X-Auth-LibraryId
string 
required
Default:
89898172-d32b-49f8-a94a-bdf0c6ca1bd9
X-Auth-ApiKey
string 
required
Default:
pEBPYVUNMbP7uDsb0W2h3oTjpEqr32fFh/3TNUhvFcJt7/J/hyV+5LctVWONgzaw+w+PpQ
Body Params application/json
paths
array[string]
required
Purge by URL — clears the cache of a specific file (recommended type). The URL should start with /. You don't need to write a domain name. Specify file URLs including query strings.Limitations:To clear the cache properly, we recommend using other types of Purge in the following cases:Vary response header is used. If your origin serves variants of the same content depending on the Vary HTTP response header, purge by URL will delete only one version of the file.If the slice option is true. If you update several files in origin without clearing the CDN cache, Purge by URL will delete only the first slice (with bytes=0…).Purge by URL depends on the following options: ignoreQueryString, query_params_blacklist, query_params_whitelist.If the ignoreQueryString is true, don’t specify parameters in the Purge request.If the query_params_whitelist is used, only files with the parameters listed in the option will be cached as different objects. Files with other parameters will be cached as one object. In this case, specify the listed parameters in any order in the Purge request. Other parameters shouldn’t be specified.If the query_params_blacklist is used, files with the parameters listed in the option will be cached as one object. Files with other parameters will be cached as different objects. In this case, specify other parameters (if any) besides the ones listed in any order in the Purge request.
Example
{
    "type": "all",
    "paths": []
}

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://apistream.gotipath.com/v1/distributions/292e5d7f-a8b9-41a0-bdf0-e70347709c6f/purges' \
--header 'X-Auth-ClientId;' \
--header 'X-Auth-LibraryId;' \
--header 'X-Auth-ApiKey;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "type": "all",
    "paths": []
}'

Responses

🟢200OK
application/json
Body
object {0}
Example
{}
🟠400Bad Request
🟠422Parameter Error
🟠401Unauthorized
Modified at 2023-09-19 14:46:20
Previous
Create Prefetch
Next
Volume usage
Built with