---
# @generated by sylphx-gen 0.1.0 from contracts@fb95f0c42a0ec5d8e3cb694c0054b529c0b24b184112c65ef60c9044b4ce61f9. Do not edit.
title: "Profile versions"
description: "The `profile_versions` collection of Sylphx Secrets: A ProfileVersion is one immutable, encrypted state of a Profile."
type: reference
product: platform
summary: "A ProfileVersion is one immutable, encrypted state of a Profile."
updated: 2026-09-28
order: 900
---

A ProfileVersion is one immutable, encrypted state of a Profile.

**Service** Sylphx Secrets · **Resource type** `secrets.sylphx.com/ProfileVersion` · **Name pattern** `orgs/{org}/projects/{project}/envs/{env}/profiles/{profile}/profile_versions/{profile_version}` · **Shape** `record`

## Fields

| Field | Type | What it is |
| --- | --- | --- |
| `name` | `string` | `…/profiles/{profile}/profile_versions/{profile_version}`; the id is the version number, from 1. |
| `uid` | `string` | `pflv_<cell><ulid>`. Output only. |
| `meta` | `ResourceMeta` | Resource metadata. |
| `sites` | `ProfileSite[]` | The sites it holds and when each last changed. Output only. |
| `base_version` | `string` | The version the write was based on; empty for a first write. Output only. |
| `conflict_version` | `string` | Set when another version landed after the base: that version, whose sites this one kept where this write did not change them. Output only. |
| `size_bytes` | `int64` | The size of the state, in bytes. Output only. |

## Methods

Every method of the collection, in the registry's order, with the scope it
needs. The full request, response and examples are one link away.

| Method | Call | What it does |
| --- | --- | --- |
| `GET` | [`get`](/docs/api/profile_versions#get) | Gets a profile version: its sites and lineage; never a value. |
| `GET` | [`list`](/docs/api/profile_versions#list) | Lists a profile's versions, newest first. |

## get

Gets a profile version: its sites and lineage; never a value.

`GET https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/profiles/profile/profile_versions/profile-version` · scope `secrets:read` · effect `read` · [Request, response and examples](/docs/api/profile_versions/get)

## list

Lists a profile's versions, newest first.

`GET https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/profiles/profile/profile_versions` · scope `secrets:read` · effect `read` · paginated · [Request, response and examples](/docs/api/profile_versions/list)