Skip to main content
POST
/
step1
/
storeskills
/
verify-url
curl -X POST https://api.yourservice.com/api/v1/step1/storeskills/verify-url \
  -H "Content-Type: application/json" \
  -d '{ "url": "https://github.com/user/my-project" }'

{
  "success": true,
  "data": {
    "accessible": true,
    "message": "Link is publicly accessible"
  }
}

​
Overview

Performs a HEAD request to the given URL with a 5-second timeout and returns whether it is publicly reachable. Useful for validating proof URLs before submission.
This endpoint always returns HTTP 200. Use the accessible boolean in the response body to determine the actual result.
No authentication required for this endpoint.

​
Request Body

​
url
string
required
The URL to check. Must start with http:// or https://.

​
Response

​
success
boolean
Always true (HTTP errors are expressed via the accessible field).
​
data
object

​
HTTP Status Code Mappings

StatusMessage
2xxLink is publicly accessible
401Link requires login — not publicly accessible
403Link is restricted — not publicly accessible
404Link not found
410Link no longer exists
429Too many requests — try again later
5xxLink server error
Timeout (5s)Link took too long to respond
UnreachableLink is not reachable

​
Error Codes

ConditionHTTPDescription
url missing or blank400{ "success": false, "message": "URL is required" }
Unexpected error500{ "success": false, "message": "..." }
curl -X POST https://api.yourservice.com/api/v1/step1/storeskills/verify-url \
  -H "Content-Type: application/json" \
  -d '{ "url": "https://github.com/user/my-project" }'

{
  "success": true,
  "data": {
    "accessible": true,
    "message": "Link is publicly accessible"
  }
}