Skip to main content
PATCH
https://api.folkyn.com
/
api
/
v1
/
freelancers
/
{id}
curl --request PATCH \
  --url https://api.folkyn.com/api/v1/freelancers/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "external_id": "ERP-F-88421",
  "note": "Preferred for Q3 staffing"
}
'
{
  "data": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "email": "<string>",
    "external_id": "<string>",
    "job_title": "<string>",
    "note": "<string>",
    "referent": {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "first_name": "<string>",
      "last_name": "<string>",
      "email": "<string>"
    },
    "tags": [
      {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "name": "<string>"
      }
    ],
    "teams": [
      {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "name": "<string>"
      }
    ],
    "kyc_complete": true,
    "master_agreement_active": true,
    "created_at": "2023-11-07T05:31:56Z",
    "first_name": "<string>",
    "last_name": "<string>"
  }
}

Authorizations

​
Authorization
string
header
required

Use Authorization: Bearer <your_api_key>

Path Parameters

​
id
string<uuid>
required

Freelancer profile UUID (not a pending invitation id).

Body

application/json

At least one field required. tag_ids and team_ids replace the full team-scoped assignment (same semantics as the Folkyn app). Send referent_id: null to clear the referent.

​
external_id
string | null

Team-stored external identifier (freelancer_teams.external_id); null clears it.

​
note
string | null

Internal team note (freelancer_teams.note); null clears it.

​
tag_ids
string<uuid>[]

Team tag UUIDs to assign (replaces existing tags for this team).

​
team_ids
string<uuid>[]

Organizational team (team unit) UUIDs to assign (replaces existing assignments for this team).

​
department_ids
string<uuid>[]
deprecated

Deprecated alias for team_ids. Use team_ids instead.

​
job_title
string | null

Job title / métier on the team link (freelancer_teams.job_title).

​
referent_id
string<uuid> | null

Team member profile UUID as referent; must belong to the API key's team.

Response

Success

​
data
object