LoginSign up

Share Links

Generate and manage temporary share links for airtags and devices with the AirPinpoint API.

Share Links

The Share Links endpoints allow you to generate temporary links that can be shared with others to view a trackable device's location.

Generate Share Link

Create a temporary share link for a specific trackable device.

Endpoint

POST /share-links

Request Body

{
  "trackableId": "device_123456",
  "hours": 24
}
  • trackableId: ID of the trackable device (required)
  • hours: Number of hours the link should be valid (required, between 1-168)

Example Request

curl -X POST "https://api.airpinpoint.com/v1/share-links" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
       "trackableId": "device_123456",
       "hours": 24
     }'

Example Response

{
  "shareUrl": "https://airpinpoint.com/share/8a7b6c5d-4e3f-2d1c-0b9a-8c7d6e5f4g3h"
}

Response Format

The response includes:

  • shareUrl: A fully qualified URL that can be shared with others to view the device's location

Error Responses

  • 400 Bad Request: Invalid hours value (must be between 1 and 168)
  • 404 Not Found: Trackable device not found or you don't have access to it
  • 500 Internal Server Error: Failed to create share link
See all posts