Skip to main content

​
List All Experiences

Authentication Required: This endpoint requires a valid JWT token.
GET /api/me/experience
Retrieve all work experience entries for the authenticated user.

​
Response

​
status
string
Response status (“success” or “error”)
​
message
string
Response message
​
data
array
Array of experience entries
​
id
long
Experience entry ID
​
company
string
Company name
​
role
string
Job role/title
​
location
string
Job location
​
startDate
string
Start date (ISO 8601 format: YYYY-MM-DD)
​
endDate
string
End date (ISO 8601 format: YYYY-MM-DD), null if current
​
current
boolean
Whether this is a current position
​
description
string
Job description and responsibilities
curl -X GET https://api.portfoliohub.com/api/me/experience \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"

​
Get Experience by ID

Authentication Required: This endpoint requires a valid JWT token.
GET /api/me/experience/{id}
Retrieve a specific work experience entry by ID.

​
Path Parameters

​
id
long
required
Experience entry ID

​
Response

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

​
Create Experience

Authentication Required: This endpoint requires a valid JWT token.
POST /api/me/experience
Create a new work experience entry.

​
Request Body

​
company
string
required
Company name (max 150 characters)
​
role
string
required
Job role/title (max 150 characters)
​
location
string
Job location (max 100 characters)
​
startDate
string
required
Start date in ISO 8601 format (YYYY-MM-DD)
​
endDate
string
End date in ISO 8601 format (YYYY-MM-DD), required if current is false
​
current
boolean
required
Whether this is a current position
​
description
string
Job description and responsibilities (max 65535 characters)

​
Response

​
status
string
Response status (“success” or “error”)
​
message
string
Response message
​
data
object
Created experience entry
curl -X POST https://api.portfoliohub.com/api/me/experience \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "company": "Tech Corp",
    "role": "Senior Developer",
    "location": "San Francisco, CA",
    "startDate": "2022-01-15",
    "endDate": null,
    "current": true,
    "description": "Leading development of microservices architecture using Java and Spring Boot."
  }'

​
Update Experience

Authentication Required: This endpoint requires a valid JWT token.
PUT /api/me/experience/{id}
Update an existing work experience entry.

​
Path Parameters

​
id
long
required
Experience entry ID to update

​
Request Body

​
company
string
required
Company name (max 150 characters)
​
role
string
required
Job role/title (max 150 characters)
​
location
string
Job location (max 100 characters)
​
startDate
string
required
Start date in ISO 8601 format (YYYY-MM-DD)
​
endDate
string
End date in ISO 8601 format (YYYY-MM-DD)
​
current
boolean
required
Whether this is a current position
​
description
string
Job description and responsibilities (max 65535 characters)

​
Response

​
status
string
Response status (“success” or “error”)
​
message
string
Response message
​
data
object
Updated experience entry
curl -X PUT https://api.portfoliohub.com/api/me/experience/1 \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "company": "Tech Corp",
    "role": "Lead Developer",
    "location": "San Francisco, CA",
    "startDate": "2022-01-15",
    "endDate": null,
    "current": true,
    "description": "Leading development of microservices architecture and mentoring junior developers."
  }'

​
Delete Experience

Authentication Required: This endpoint requires a valid JWT token.
DELETE /api/me/experience/{id}
Delete a work experience entry.

​
Path Parameters

​
id
long
required
Experience entry 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/experience/1 \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"

Build docs developers (and LLMs) love

Get started for freeTalk to us