create_creator_profile
Idempotent
Create an owned, versioned creator profile. Free; admin scope.
At least one creator/audience/stance/fact is required. Returns the exact version,
deny-by-default secondary-use decisions, receipts, and an unverified-attestation
warning. Optional idempotency_key replays safely. Errors: unauthorized, forbidden,
invalid_request, conflict, idempotency_conflict, configuration_unavailable, rate_limited.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| stance | No | Optional: what the creator is for or against, selling, or building, so hooks carry a real position instead of a neutral summary. | |
| api_key | No | API key for this call. Omit to fall back to the Authorization: Bearer / X-API-Key request header (streamable-HTTP only), then the VHGENGINE_API_KEY env var (the stdio default). No key resolvable -> unauthorized. | |
| creator | No | Optional: who is speaking, free text ('wedding videographer, 40k followers, I talk to camera over b-roll of my shoots'). The more the engine knows about the creator, the more the hooks are theirs rather than a generic narrator's. | |
| audience | No | Optional: who watches ('engaged couples budgeting'). Aims every hook at a real audience instead of an assumed one. | |
| display_name | Yes | Account-local profile label, 1-100 characters. | |
| secondary_use | No | Each secondary-use decision is independent and denied by default. These decisions are retained for governance only: generation, scoring, retrieval, and learning do not consume them today. | |
| idempotency_key | No | Caller-chosen replay key (any string, unique per intended effect). A repeat call with the SAME key returns the stored result and is NEVER charged twice; the same key with different arguments is an idempotency_conflict. Omit and every call is a fresh, separately charged operation. | |
| authority_attested | Yes | I confirm that I am this creator or am authorized by them to store these declarations and use the selected immutable version when I later make an explicit profile-bound hook-generation request. VHGENGINE records this caller attestation; it does not verify identity, ownership, or legal authority. | |
| first_person_facts | No | Optional: facts TRUE of this creator that hooks may assert first-person ('I have filmed 200+ weddings'). The ONLY sanctioned source of personal claims; without it, hooks never invent a biography. | |
| subject_relationship | Yes | self, authorized representative, or organization representative. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| stance | No | Caller-declared speaker stance. | |
| creator | No | Caller-declared creator description. | |
| version | No | Exact immutable version returned by this read or write. | |
| audience | No | Caller-declared audience. | |
| replayed | No | true when idempotency replayed the stored write. | |
| created_at | No | Profile creation time, ISO-8601 UTC. | |
| is_current | No | Whether this immutable version is current. | |
| profile_id | No | Opaque account-owned profile id. | |
| updated_at | No | Current profile update time, ISO-8601 UTC. | |
| display_name | No | Account-local profile label. | |
| secondary_use | No | Three independent deny-by-default decisions. | |
| current_version | No | Profile's current version. | |
| attestation_note | No | Unverified-authority and non-consumption warning. | |
| consent_receipts | No | Latest revision receipt for every decision. | |
| authority_attested | No | The caller recorded the required authority attestation. | |
| first_person_facts | No | Sanctioned caller-declared facts. | |
| rights_notice_text | No | Exact immutable caller-authority notice text. | |
| version_created_at | No | This version's creation time, ISO-8601 UTC. | |
| consent_notice_text | No | Exact deny-by-default secondary-use notice text. | |
| subject_relationship | No | Caller's declared relationship to the creator. | |
| rights_notice_version | No | Immutable rights-attestation notice version. |