Portfolio Management API Endpoints | GOAT Portfolio

Overview

The Portfolio API exposes endpoints for reading and managing a user’s portfolio. Public discovery endpoints require no authentication. All other endpoints require a valid JWT issued by POST /api/usuario/login sent as an Authorization: Bearer <token> header.

GET /api/portafolios/publicos

List all portfolios that have been marked as publicly visible. Use this endpoint to power a discovery feed or directory of GOAT Portfolio users. No authentication is required.

Responses

Returns a JSON array. Each element represents one public portfolio card.

id_portafolio

string

Unique identifier for the portfolio.

enlace_pagi_web

string

Public web link for this portfolio (may be null if not configured).

usuario

object

Summary of the portfolio owner.

Show usuario fields

nombre

string

Full display name of the user.

profesion

string

The user’s stated profession or job title.

foto

string

URL of the user’s profile photo (may be null).

ubicacion

string

User’s location string (may be null).

habilidades

array

Subset of visible skills for the discovery card preview.

Show habilidades item fields

nombre

string

Skill name.

cantidad_proyectos

integer

Total number of visible projects on this portfolio.

Status	Meaning
`200`	Array of public portfolio card objects returned.

Example Request

curl https://api.goatportfolio.com/api/portafolios/publicos \
  -H "Accept: application/json"

Example Response

[
  {
    "id_portafolio": "01HXYZ987654321",
    "enlace_pagi_web": "https://goatportfolio.com/p/maria-gonzalez",
    "usuario": {
      "nombre": "María González",
      "profesion": "Full-Stack Developer",
      "foto": "https://cdn.goatportfolio.com/photos/maria.jpg",
      "ubicacion": "La Paz, Bolivia"
    },
    "habilidades": [
      { "nombre": "React" },
      { "nombre": "Laravel" },
      { "nombre": "TypeScript" }
    ],
    "cantidad_proyectos": 5
  }
]

GET /api/portafolio/completo

Retrieve the complete portfolio data for the authenticated user, including profile info, skills, work and academic experience, projects, professional networks, and the active template. This is the primary endpoint used to render the portfolio view. Authentication required — include Authorization: Bearer <token>.

Responses

usuario

object

Personal details of the authenticated user.

Show usuario fields

id_usuario

string

Unique user identifier.

nombre

string

First name.

apellido_paterno

string

Paternal surname.

apellido_materno

string

Maternal surname (may be null).

string

Registered email address.

biografia

string

Short bio / about-me text (may be null).

foto

string

Profile photo URL (may be null).

fecha

string

Account creation or profile date (may be null).

portafolio

object

Portfolio configuration and active template information.

Show portafolio fields

id_portafolio

string

Unique portfolio identifier.

id_plantilla

string

ID of the currently selected template (may be null).

enlace_pagi_web

string

Custom public URL for the portfolio (may be null).

visible

boolean

Whether the portfolio is publicly discoverable.

plantilla

object

Details of the active template.

Show plantilla fields

id_plantilla

string

Template identifier.

nombre

string

Template name — one of "Bento", "Sidebar", or "Editorial".

redes_profesionales

array

Professional network links (LinkedIn, GitHub, etc.).

Show redes_profesionales item fields

id_redes_prof

string

Unique link ID.

nombre_red

string

Platform name, e.g. "linkedin", "github".

url_red

string

Full URL to the user’s profile on that platform.

visible

boolean

Whether this link is shown on the public portfolio.

habilidades

array

All skills belonging to the portfolio.

Show habilidades item fields

id_habilidad

string

Skill ID.

nombre

string

Skill name.

nivel

integer

Proficiency percentage, 0–100.

tipo

string

'tecnica' or 'blanda'.

visible

boolean

Whether this skill is shown publicly.

experiencias_laborales

array

Work experience entries.

Show experiencias_laborales item fields

id_experiencia

string

Experience entry ID.

empresa

string

Company name.

cargo

string

Job title / role.

descripcion

string

Description of responsibilities.

fecha_ini

string

Start date (ISO 8601 date string).

fecha_fin

string

End date, or null if current position.

visible

boolean

Whether this entry appears publicly.

experiencias_academicas

array

Academic / education entries.

Show experiencias_academicas item fields

id_experiencia_academica

string

Academic entry ID.

institucion

string

Name of the institution.

titulo

string

Degree or qualification title.

descripcion

string

Additional description.

fecha_ini

string

Start date.

fecha_fin

string

End date, or null if ongoing.

visible

boolean

Whether this entry appears publicly.

proyectos

array

Portfolio projects.

Show proyectos item fields

id_proyecto

string

Project ID.

nombre

string

Project name.

descripcion

string

Project description.

url_proyecto

string

Repository or project URL (may be null).

imagen_url

string

Cover image URL (may be null).

tecnologias

array

Array of technology tag objects, each with id_tecnologia and nombre.

visible

boolean

Whether this project appears publicly.

Status	Meaning
`200`	Full portfolio data returned.
`401`	Missing or invalid token — token removed from client storage.

Example Request

curl https://api.goatportfolio.com/api/portafolio/completo \
  -H "Accept: application/json" \
  -H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9..."

Example Response

{
  "usuario": {
    "id_usuario": "01HXYZ123456789",
    "nombre": "María",
    "apellido_paterno": "González",
    "apellido_materno": "López",
    "email": "maria@example.com",
    "biografia": "Full-stack developer passionate about open source.",
    "foto": "https://cdn.goatportfolio.com/photos/maria.jpg",
    "fecha": null
  },
  "portafolio": {
    "id_portafolio": "01HXYZ987654321",
    "id_plantilla": "01KQR862E61WHCR4HK8PZVPF91",
    "enlace_pagi_web": "https://goatportfolio.com/p/maria-gonzalez",
    "visible": true,
    "plantilla": {
      "id_plantilla": "01KQR862E61WHCR4HK8PZVPF91",
      "nombre": "Bento"
    }
  },
  "redes_profesionales": [
    {
      "id_redes_prof": "01HREDES001",
      "nombre_red": "github",
      "url_red": "https://github.com/mariagonzalez",
      "visible": true
    }
  ],
  "habilidades": [
    { "id_habilidad": "01HHAB001", "nombre": "React", "nivel": 90, "tipo": "tecnica", "visible": true }
  ],
  "experiencias_laborales": [
    {
      "id_experiencia": "01HEXP001",
      "empresa": "Acme Corp",
      "cargo": "Frontend Developer",
      "descripcion": "Built and maintained React applications.",
      "fecha_ini": "2022-01-01",
      "fecha_fin": null,
      "visible": true
    }
  ],
  "experiencias_academicas": [
    {
      "id_experiencia_academica": "01HACAD001",
      "institucion": "Universidad Mayor de San Andrés",
      "titulo": "Ingeniería en Sistemas",
      "descripcion": "Computer science and software engineering degree.",
      "fecha_ini": "2018-02-01",
      "fecha_fin": "2022-12-01",
      "visible": true
    }
  ],
  "proyectos": [
    {
      "id_proyecto": "01HPROY001",
      "nombre": "E-Commerce Platform",
      "descripcion": "A full-stack online store built with React and Laravel.",
      "url_proyecto": "https://github.com/mariagonzalez/ecommerce",
      "imagen_url": "https://cdn.goatportfolio.com/projects/ecommerce.png",
      "tecnologias": [
        { "id_tecnologia": "01HTEC001", "nombre": "React" },
        { "id_tecnologia": "01HTEC002", "nombre": "Laravel" }
      ],
      "visible": true
    }
  ]
}

PATCH /api/portafolio/actualizar-plantilla

Update the portfolio’s active visual template. Choose from the three available layouts — Bento, Sidebar, or Editorial — by providing the template’s ID from the template catalog. Authentication required — include Authorization: Bearer <token>.

Request Body

id_plantilla

string

required

The id_plantilla of the desired template. Obtain valid IDs from GET /api/plantillas/catalogo.

Responses

message

string

Confirmation that the template was updated.

Status	Meaning
`200`	Template updated successfully.
`401`	Unauthorized — missing or invalid token.
`422`	Validation error — `id_plantilla` not provided or not found.

Example Request

curl -X PATCH https://api.goatportfolio.com/api/portafolio/actualizar-plantilla \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9..." \
  -d '{ "id_plantilla": "01KQR8685VJ6E9KY278ABW3AZZ" }'

Example Response

{
  "message": "Template updated successfully."
}

GET /api/plantillas/catalogo

Retrieve the full list of available portfolio templates. No authentication is required. The three currently supported templates are Bento, Sidebar, and Editorial.

Responses

data

array

Array of available template objects.

Show template item fields

id_plantilla

string

Unique identifier for the template. Pass this value to PATCH /api/portafolio/actualizar-plantilla.

nombre

string

Template display name — one of "Bento", "Sidebar", or "Editorial".

descripcion

string

Short description of the template’s layout style.

url_vista

string

URL of a preview image or live demo for the template.

Status	Meaning
`200`	Template catalog returned.

Example Request

curl https://api.goatportfolio.com/api/plantillas/catalogo \
  -H "Accept: application/json"

Example Response

{
  "data": [
    {
      "id_plantilla": "01KQR862E61WHCR4HK8PZVPF91",
      "nombre": "Bento",
      "descripcion": "A modern bento-grid layout with featured project cards and skill highlights.",
      "url_vista": "https://cdn.goatportfolio.com/templates/bento-preview.png"
    },
    {
      "id_plantilla": "01KQR8685VJ6E9KY278ABW3AZZ",
      "nombre": "Sidebar",
      "descripcion": "Two-column layout with a sticky profile sidebar and scrollable main content.",
      "url_vista": "https://cdn.goatportfolio.com/templates/sidebar-preview.png"
    },
    {
      "id_plantilla": "01KQR869F2CJPHC6446XFVSJAD",
      "nombre": "Editorial",
      "descripcion": "Magazine-style editorial layout with large typography and a full-width hero.",
      "url_vista": "https://cdn.goatportfolio.com/templates/editorial-preview.png"
    }
  ]
}

Overview

Endpoints

Documentation Index

​Overview

​GET /api/portafolios/publicos

​Responses

​Example Request

​Example Response

​GET /api/portafolio/completo

​Responses

​Example Request

​Example Response

​PATCH /api/portafolio/actualizar-plantilla

​Request Body

​Responses

​Example Request

​Example Response

​GET /api/plantillas/catalogo

​Responses

​Example Request

​Example Response

Build docs developers (and LLMs) love

Overview

GET /api/portafolios/publicos

Responses

Example Request

Example Response

GET /api/portafolio/completo

Responses

Example Request

Example Response

PATCH /api/portafolio/actualizar-plantilla

Request Body

Responses

Example Request

Example Response

GET /api/plantillas/catalogo

Responses

Example Request

Example Response