Skip to main content
GET
/
api
/
network
/
connections
/
{id}
/
detail
Fetch details for a network connection
curl --request GET \
  --url https://app.puffle.ai/api/network/connections/{id}/detail \
  --header 'Authorization: Bearer <token>'
{
  "experience": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "companyName": "<string>",
      "companyLinkedinUrl": "<string>",
      "position": "<string>",
      "location": "<string>",
      "employmentType": "<string>",
      "workplaceType": "<string>",
      "description": "<string>",
      "startDate": "<string>",
      "endDate": "<string>",
      "isCurrent": true,
      "durationMonths": 0
    }
  ],
  "education": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "schoolName": "<string>",
      "schoolLinkedinUrl": "<string>",
      "degree": "<string>",
      "fieldOfStudy": "<string>",
      "startDate": "<string>",
      "endDate": "<string>"
    }
  ],
  "skills": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    }
  ],
  "certifications": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    }
  ],
  "languages": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    }
  ],
  "projects": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    }
  ],
  "volunteering": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    }
  ],
  "publications": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    }
  ],
  "awards": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    }
  ],
  "courses": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    }
  ],
  "messages": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "conversationId": "<string>",
      "conversationTitle": "<string>",
      "fromName": "<string>",
      "fromLinkedinUrl": "<string>",
      "toName": "<string>",
      "toLinkedinUrl": "<string>",
      "sentAt": "<string>",
      "subject": "<string>",
      "content": "<string>",
      "folder": "<string>",
      "isFromMe": true,
      "hasAttachments": true,
      "isDraft": true
    }
  ]
}

​
Overview

Returns the full connection payload:
  • experience — mapped camelCase rows from network_connection_experience, current roles first
  • education — rows from network_connection_education, newest end_date first
  • skills / certifications / languages / projects / volunteering / publications / awards / courses — all sourced from the single network_connection_details table, partitioned by type and flattened so the row’s data keys appear at the top level next to id
  • messages — up to 100 most-recent messages between the caller and this connection, newest first
All detail arrays are empty for basic (un-enriched) connections. messages may still be populated regardless of enrichment status if messages were imported.

​
AI agent notes

Ownership is enforced. A connection belonging to another user returns 403, not 404. Treat both as “not yours” for UX purposes.Detail shape is open. Each detail row merges its JSONB data column into the response object alongside id, so the exact keys depend on the detail type (e.g. skills have endorsement_count, certifications have issued_at). Downstream agents should not assume a closed schema for these arrays.Messages are capped at 100. If you need older messages for this connection, call listNetworkMessages with connectionId and paginate.No enrichment trigger here. This endpoint only reads. To populate detail arrays for a basic connection, call enrichNetworkConnections first.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
id
string<uuid>
required

Network connection UUID.

Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$

Response

Connection detail payload.

Full enriched-profile detail partitioned by detail type. All arrays are empty for basic (un-enriched) connections; messages may still be populated if messages were imported.

​
experience
object[]
required
​
education
object[]
required
​
skills
object[]
required
​
certifications
object[]
required
​
languages
object[]
required
​
projects
object[]
required
​
volunteering
object[]
required
​
publications
object[]
required
​
awards
object[]
required
​
courses
object[]
required
​
messages
object[]
required

Up to 100 most-recent messages between the caller and this connection, newest first.