Skip to main content
Authentication Required: This endpoint requires a valid JWT token.
GET /api/me/social-links
Retrieve all social media links for the authenticated user.

Response

status
string
Response status (“success” or “error”)
message
string
Response message
data
array
Array of social link entries
id
long
Social link ID
platform
string
Social media platform name (e.g., “GitHub”, “LinkedIn”, “Twitter”)
url
string
Full URL to the social profile
sortOrder
integer
Display order for sorting links
curl -X GET https://api.portfoliohub.com/api/me/social-links \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"

Authentication Required: This endpoint requires a valid JWT token.
GET /api/me/social-links/{id}
Retrieve a specific social link entry by ID.

Path Parameters

id
long
required
Social link ID

Response

status
string
Response status (“success” or “error”)
message
string
Response message
data
object
Social link details (same structure as list items)
curl -X GET https://api.portfoliohub.com/api/me/social-links/1 \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"

Authentication Required: This endpoint requires a valid JWT token.
POST /api/me/social-links
Create a new social media link.

Request Body

platform
string
required
Social media platform name (max 50 characters)
url
string
required
Full URL to the social profile (must be valid URL, max 512 characters)
sortOrder
integer
required
Display order for sorting links

Response

status
string
Response status (“success” or “error”)
message
string
Response message
data
object
Created social link entry
curl -X POST https://api.portfoliohub.com/api/me/social-links \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "platform": "GitHub",
    "url": "https://github.com/johndoe",
    "sortOrder": 1
  }'

Authentication Required: This endpoint requires a valid JWT token.
PUT /api/me/social-links/{id}
Update an existing social media link.

Path Parameters

id
long
required
Social link ID to update

Request Body

platform
string
required
Social media platform name (max 50 characters)
url
string
required
Full URL to the social profile (must be valid URL, max 512 characters)
sortOrder
integer
required
Display order for sorting links

Response

status
string
Response status (“success” or “error”)
message
string
Response message
data
object
Updated social link entry
curl -X PUT https://api.portfoliohub.com/api/me/social-links/1 \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "platform": "GitHub",
    "url": "https://github.com/johndoe-updated",
    "sortOrder": 1
  }'

Authentication Required: This endpoint requires a valid JWT token.
DELETE /api/me/social-links/{id}
Delete a social media link.

Path Parameters

id
long
required
Social link ID to delete

Response

status
string
Response status (“success” or “error”)
message
string
Response message
data
null
No data returned on successful deletion
curl -X DELETE https://api.portfoliohub.com/api/me/social-links/1 \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"

Common Social Platforms

Here are some commonly used platform names for consistency:
  • GitHub - For GitHub profiles
  • LinkedIn - For LinkedIn profiles
  • Twitter - For Twitter/X profiles
  • Instagram - For Instagram profiles
  • Facebook - For Facebook profiles
  • YouTube - For YouTube channels
  • Medium - For Medium blogs
  • Dev.to - For Dev.to profiles
  • Stack Overflow - For Stack Overflow profiles
  • Behance - For Behance portfolios
  • Dribbble - For Dribbble portfolios
  • CodePen - For CodePen profiles
  • Website - For personal websites

Build docs developers (and LLMs) love