Update Profile

curl --request PATCH \
  --url https://api.mokaru.ai/v1/profile \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "firstName": "<string>",
  "lastName": "<string>",
  "email": "<string>",
  "phone": "<string>",
  "address": "<string>",
  "country": "<string>",
  "province": "<string>",
  "jobTitle": "<string>",
  "summary": "<string>",
  "sector": "<string>",
  "nationality": "<string>",
  "pronouns": "<string>",
  "linkedIn": "<string>",
  "website": "<string>",
  "portfolio": "<string>",
  "github": "<string>",
  "summaries": {},
  "projects": {},
  "certificates": {},
  "awards": {},
  "publications": {},
  "interests": {},
  "jobTitles": {}
}
'

import requests

url = "https://api.mokaru.ai/v1/profile"

payload = {
    "firstName": "<string>",
    "lastName": "<string>",
    "email": "<string>",
    "phone": "<string>",
    "address": "<string>",
    "country": "<string>",
    "province": "<string>",
    "jobTitle": "<string>",
    "summary": "<string>",
    "sector": "<string>",
    "nationality": "<string>",
    "pronouns": "<string>",
    "linkedIn": "<string>",
    "website": "<string>",
    "portfolio": "<string>",
    "github": "<string>",
    "summaries": {},
    "projects": {},
    "certificates": {},
    "awards": {},
    "publications": {},
    "interests": {},
    "jobTitles": {}
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    firstName: '<string>',
    lastName: '<string>',
    email: '<string>',
    phone: '<string>',
    address: '<string>',
    country: '<string>',
    province: '<string>',
    jobTitle: '<string>',
    summary: '<string>',
    sector: '<string>',
    nationality: '<string>',
    pronouns: '<string>',
    linkedIn: '<string>',
    website: '<string>',
    portfolio: '<string>',
    github: '<string>',
    summaries: {},
    projects: {},
    certificates: {},
    awards: {},
    publications: {},
    interests: {},
    jobTitles: {}
  })
};

fetch('https://api.mokaru.ai/v1/profile', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.mokaru.ai/v1/profile",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PATCH",
  CURLOPT_POSTFIELDS => json_encode([
    'firstName' => '<string>',
    'lastName' => '<string>',
    'email' => '<string>',
    'phone' => '<string>',
    'address' => '<string>',
    'country' => '<string>',
    'province' => '<string>',
    'jobTitle' => '<string>',
    'summary' => '<string>',
    'sector' => '<string>',
    'nationality' => '<string>',
    'pronouns' => '<string>',
    'linkedIn' => '<string>',
    'website' => '<string>',
    'portfolio' => '<string>',
    'github' => '<string>',
    'summaries' => [
        
    ],
    'projects' => [
        
    ],
    'certificates' => [
        
    ],
    'awards' => [
        
    ],
    'publications' => [
        
    ],
    'interests' => [
        
    ],
    'jobTitles' => [
        
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.mokaru.ai/v1/profile"

	payload := strings.NewReader("{\n  \"firstName\": \"<string>\",\n  \"lastName\": \"<string>\",\n  \"email\": \"<string>\",\n  \"phone\": \"<string>\",\n  \"address\": \"<string>\",\n  \"country\": \"<string>\",\n  \"province\": \"<string>\",\n  \"jobTitle\": \"<string>\",\n  \"summary\": \"<string>\",\n  \"sector\": \"<string>\",\n  \"nationality\": \"<string>\",\n  \"pronouns\": \"<string>\",\n  \"linkedIn\": \"<string>\",\n  \"website\": \"<string>\",\n  \"portfolio\": \"<string>\",\n  \"github\": \"<string>\",\n  \"summaries\": {},\n  \"projects\": {},\n  \"certificates\": {},\n  \"awards\": {},\n  \"publications\": {},\n  \"interests\": {},\n  \"jobTitles\": {}\n}")

	req, _ := http.NewRequest("PATCH", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.patch("https://api.mokaru.ai/v1/profile")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"firstName\": \"<string>\",\n  \"lastName\": \"<string>\",\n  \"email\": \"<string>\",\n  \"phone\": \"<string>\",\n  \"address\": \"<string>\",\n  \"country\": \"<string>\",\n  \"province\": \"<string>\",\n  \"jobTitle\": \"<string>\",\n  \"summary\": \"<string>\",\n  \"sector\": \"<string>\",\n  \"nationality\": \"<string>\",\n  \"pronouns\": \"<string>\",\n  \"linkedIn\": \"<string>\",\n  \"website\": \"<string>\",\n  \"portfolio\": \"<string>\",\n  \"github\": \"<string>\",\n  \"summaries\": {},\n  \"projects\": {},\n  \"certificates\": {},\n  \"awards\": {},\n  \"publications\": {},\n  \"interests\": {},\n  \"jobTitles\": {}\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.mokaru.ai/v1/profile")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"firstName\": \"<string>\",\n  \"lastName\": \"<string>\",\n  \"email\": \"<string>\",\n  \"phone\": \"<string>\",\n  \"address\": \"<string>\",\n  \"country\": \"<string>\",\n  \"province\": \"<string>\",\n  \"jobTitle\": \"<string>\",\n  \"summary\": \"<string>\",\n  \"sector\": \"<string>\",\n  \"nationality\": \"<string>\",\n  \"pronouns\": \"<string>\",\n  \"linkedIn\": \"<string>\",\n  \"website\": \"<string>\",\n  \"portfolio\": \"<string>\",\n  \"github\": \"<string>\",\n  \"summaries\": {},\n  \"projects\": {},\n  \"certificates\": {},\n  \"awards\": {},\n  \"publications\": {},\n  \"interests\": {},\n  \"jobTitles\": {}\n}"

response = http.request(request)
puts response.read_body

{
  "success": true
}

PATCH

profile

Update Profile

curl --request PATCH \
  --url https://api.mokaru.ai/v1/profile \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "firstName": "<string>",
  "lastName": "<string>",
  "email": "<string>",
  "phone": "<string>",
  "address": "<string>",
  "country": "<string>",
  "province": "<string>",
  "jobTitle": "<string>",
  "summary": "<string>",
  "sector": "<string>",
  "nationality": "<string>",
  "pronouns": "<string>",
  "linkedIn": "<string>",
  "website": "<string>",
  "portfolio": "<string>",
  "github": "<string>",
  "summaries": {},
  "projects": {},
  "certificates": {},
  "awards": {},
  "publications": {},
  "interests": {},
  "jobTitles": {}
}
'

import requests

url = "https://api.mokaru.ai/v1/profile"

payload = {
    "firstName": "<string>",
    "lastName": "<string>",
    "email": "<string>",
    "phone": "<string>",
    "address": "<string>",
    "country": "<string>",
    "province": "<string>",
    "jobTitle": "<string>",
    "summary": "<string>",
    "sector": "<string>",
    "nationality": "<string>",
    "pronouns": "<string>",
    "linkedIn": "<string>",
    "website": "<string>",
    "portfolio": "<string>",
    "github": "<string>",
    "summaries": {},
    "projects": {},
    "certificates": {},
    "awards": {},
    "publications": {},
    "interests": {},
    "jobTitles": {}
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    firstName: '<string>',
    lastName: '<string>',
    email: '<string>',
    phone: '<string>',
    address: '<string>',
    country: '<string>',
    province: '<string>',
    jobTitle: '<string>',
    summary: '<string>',
    sector: '<string>',
    nationality: '<string>',
    pronouns: '<string>',
    linkedIn: '<string>',
    website: '<string>',
    portfolio: '<string>',
    github: '<string>',
    summaries: {},
    projects: {},
    certificates: {},
    awards: {},
    publications: {},
    interests: {},
    jobTitles: {}
  })
};

fetch('https://api.mokaru.ai/v1/profile', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.mokaru.ai/v1/profile",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PATCH",
  CURLOPT_POSTFIELDS => json_encode([
    'firstName' => '<string>',
    'lastName' => '<string>',
    'email' => '<string>',
    'phone' => '<string>',
    'address' => '<string>',
    'country' => '<string>',
    'province' => '<string>',
    'jobTitle' => '<string>',
    'summary' => '<string>',
    'sector' => '<string>',
    'nationality' => '<string>',
    'pronouns' => '<string>',
    'linkedIn' => '<string>',
    'website' => '<string>',
    'portfolio' => '<string>',
    'github' => '<string>',
    'summaries' => [
        
    ],
    'projects' => [
        
    ],
    'certificates' => [
        
    ],
    'awards' => [
        
    ],
    'publications' => [
        
    ],
    'interests' => [
        
    ],
    'jobTitles' => [
        
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.mokaru.ai/v1/profile"

	payload := strings.NewReader("{\n  \"firstName\": \"<string>\",\n  \"lastName\": \"<string>\",\n  \"email\": \"<string>\",\n  \"phone\": \"<string>\",\n  \"address\": \"<string>\",\n  \"country\": \"<string>\",\n  \"province\": \"<string>\",\n  \"jobTitle\": \"<string>\",\n  \"summary\": \"<string>\",\n  \"sector\": \"<string>\",\n  \"nationality\": \"<string>\",\n  \"pronouns\": \"<string>\",\n  \"linkedIn\": \"<string>\",\n  \"website\": \"<string>\",\n  \"portfolio\": \"<string>\",\n  \"github\": \"<string>\",\n  \"summaries\": {},\n  \"projects\": {},\n  \"certificates\": {},\n  \"awards\": {},\n  \"publications\": {},\n  \"interests\": {},\n  \"jobTitles\": {}\n}")

	req, _ := http.NewRequest("PATCH", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.patch("https://api.mokaru.ai/v1/profile")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"firstName\": \"<string>\",\n  \"lastName\": \"<string>\",\n  \"email\": \"<string>\",\n  \"phone\": \"<string>\",\n  \"address\": \"<string>\",\n  \"country\": \"<string>\",\n  \"province\": \"<string>\",\n  \"jobTitle\": \"<string>\",\n  \"summary\": \"<string>\",\n  \"sector\": \"<string>\",\n  \"nationality\": \"<string>\",\n  \"pronouns\": \"<string>\",\n  \"linkedIn\": \"<string>\",\n  \"website\": \"<string>\",\n  \"portfolio\": \"<string>\",\n  \"github\": \"<string>\",\n  \"summaries\": {},\n  \"projects\": {},\n  \"certificates\": {},\n  \"awards\": {},\n  \"publications\": {},\n  \"interests\": {},\n  \"jobTitles\": {}\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.mokaru.ai/v1/profile")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"firstName\": \"<string>\",\n  \"lastName\": \"<string>\",\n  \"email\": \"<string>\",\n  \"phone\": \"<string>\",\n  \"address\": \"<string>\",\n  \"country\": \"<string>\",\n  \"province\": \"<string>\",\n  \"jobTitle\": \"<string>\",\n  \"summary\": \"<string>\",\n  \"sector\": \"<string>\",\n  \"nationality\": \"<string>\",\n  \"pronouns\": \"<string>\",\n  \"linkedIn\": \"<string>\",\n  \"website\": \"<string>\",\n  \"portfolio\": \"<string>\",\n  \"github\": \"<string>\",\n  \"summaries\": {},\n  \"projects\": {},\n  \"certificates\": {},\n  \"awards\": {},\n  \"publications\": {},\n  \"interests\": {},\n  \"jobTitles\": {}\n}"

response = http.request(request)
puts response.read_body

{
  "success": true
}

Overview

The Update Profile endpoint lets you modify your career profile. The scalar identity and contact fields (name, email, phone, address, links, and the profile scalars below) are shared and appear on every resume - editing them here propagates to all resumes. The collection arrays (summaries, projects, certificates, etc.) write your base (default) resume’s content, which is the canonical content that new resumes are copied from. Common use cases:

AI agent profile management - keep your profile up to date as your career evolves.
Bulk updates - update multiple fields at once after a job change.
LinkedIn sync - pull data from LinkedIn and push it to your Mokaru profile.

Scope required: profile:write | Rate limit: 20 requests/min

Request

PATCH /v1/profile

Body Parameters

All fields are optional. Only include the fields you want to change. Pass null to clear a field.

string

First name (max 100 characters)

string

Last name (max 100 characters)

string

Email address (max 254 characters)

string

Phone number (max 50 characters, null to clear)

string

Address (max 200 characters, null to clear)

string

Country (max 100 characters, null to clear)

string

Province or state (max 100 characters, null to clear)

string

Current job title (max 200 characters, null to clear)

string

Professional summary (max 2000 characters, null to clear)

string

Industry sector (max 100 characters, null to clear)

string

Nationality (max 100 characters, null to clear)

string

Pronouns (max 50 characters, null to clear)

string

LinkedIn username or URL (max 500 characters, null to clear)

string

Personal website URL (max 500 characters, null to clear)

string

Portfolio URL (max 500 characters, null to clear)

string

GitHub URL (max 500 characters, null to clear)

Collection fields (replace-list semantics)

These accept full arrays. Passing an array REPLACES the entire collection. To add one item without losing existing entries, first call GET /v1/profile, append to the returned array, then send the full updated array back. Omit the field to leave the collection unchanged; pass [] to clear it. Hard cap of 100 items per collection (50 for jobTitles).

array (max 100)

Professional summary versions: { title?: string, content: string }[]

array (max 100)

Projects: { name, description, organisation?, startDate?, endDate?, isCurrent?, url? }[]

array (max 100)

Certificates: { name, issuer, description?, issueDate?, expiryDate?, credentialId?, verificationUrl? }[]

array (max 100)

Awards: { name, organisation?, description?, date? }[]

array (max 100)

Publications: { name, publisher?, date?, url?, description? }[]

array (max 100)

Interests: { name, description? }[]

array (max 50)

Career-identity job titles: { title: string }[]

Example

curl -X PATCH "https://api.mokaru.ai/v1/profile" \
  -H "Authorization: Bearer mk_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "firstName": "Jane",
    "lastName": "Smith",
    "jobTitle": "Senior Software Engineer",
    "linkedIn": "jane-smith",
    "sector": "Technology"
  }'

Response

boolean

Whether the profile was updated

{
  "success": true
}

LinkedIn usernames are automatically converted to full URLs. For example, "jane-smith" becomes "https://linkedin.com/in/jane-smith". Website and portfolio URLs have https:// prepended if no protocol is specified.

API Reference

Jobs

Applications

Contacts

Experiences

Education

Skills

Resumes

Resume Sharing

Cover Letters

Profile

Summaries

Projects

Certificates

Awards

Publications

Interests

Custom Sections

Update Profile

Overview

Request

Body Parameters

Collection fields (replace-list semantics)

Example

Response

​Overview

​Request

​Body Parameters

​Collection fields (replace-list semantics)

​Example

​Response

Overview

Request

Body Parameters

Collection fields (replace-list semantics)

Example

Response