---
title: "Write profile file node"
method: PUT
path: "/v1/profile/{userId}/write"
tags: ["Files"]
---

# Write profile file node

`PUT /v1/profile/{userId}/write`

## Request

- Base URL: `https://api.configure.dev`
- URL: `https://api.configure.dev/v1/profile/{userId}/write`
- Auth: one of:
  - API key in header `X-API-Key` and HTTP bearer
  - API key in header `X-API-Key` and API key in header `X-User-Id`

Requires a secret key. Federated users are namespace-fenced to /agents/{resolved-agent}; unlinked developer-scoped profiles may also manage root profile paths.

## Path parameters

- `userId` string, required

## Headers

- `X-Agent` string

## Request body

- FileWriteRequest
  - `path` string, required
  - `content` string, required
  - `type` 'json' | 'markdown'
  - `mode` 'overwrite' | 'append' | 'merge'

## Response `200`

Write result.

- FileWriteResult
  - `path` string
  - `version` integer

---

[API](https://skmtc.dev/configure/apis/configure-http-api.md) · [All operations](https://skmtc.dev/configure/apis/configure-http-api/llms.txt) · [OpenAPI document](https://skmtc.dev/configure/apis/configure-http-api/revisions/ec760a9533d2?raw)