---
title: "Read versioned creator context"
method: GET
path: "/agent/creator-context"
---

# Read versioned creator context

`GET /agent/creator-context`

## Request

- Base URL: `https://api.bamf.ai/v1`
- URL: `https://api.bamf.ai/v1/agent/creator-context`
- Auth: HTTP bearer

Returns an exact positive projection through server-resolved creator authorization. This additive operation does not change the legacy creator-context route/tool/resource.

## Query parameters

- `creator_id` string, required
- `sections` string: Comma-separated unique subset of profile,context,voice_profile,linkedin_profile,website,brand_kits,media.
- `limit` integer

## Response `200`

Versioned public creator context

- AgentCreatorContextOperationResponse
  - `schema` 'bamf.operation-result/v1', required
  - `operation_ref` 'bamf.creator.context.read/v1', required
  - `data` AgentCreatorContextData, required
    - `creator_id` string, required
    - `generated_at` string, date-time, required
    - `requested_sections` string[], required
    - `omitted_sections` object[], required
      - `section` 'media', required
      - `required_scope` 'media:read', required
    - `profile` AgentCreatorProfile
      - `id` string, required
      - `creator_id` string, required
      - `name` string, nullable, required
      - `bio` string, nullable, required
      - `industry` string, nullable, required
      - `job_description` string, nullable, required
      - `avatar_url` string, nullable, required
      - `linkedin_username` string, nullable, required
      - `linkedin_headline` string, nullable, required
      - `linkedin_profile_url` string, nullable, required
      - `website_url` string, nullable, required
    - `context` object
      - `identity_profile` unknown, required
      - `writing_preferences` unknown, required
      - `ai_analysis_summaries` unknown, required
    - `voice_profile` object
      - `fine_tune` string, nullable, required
      - `fine_tune_v2` string, nullable, required
      - `voice_settings` unknown, required
      - `writing_preferences` unknown, required
    - `linkedin_profile` LinkedInCreatorProfile, nullable
      - `id` string
      - `url` string, nullable
      - `name` string, nullable
      - `headline` string, nullable
      - `bio` string, nullable
      - `job_title` string, nullable
      - `company_name` string, nullable
      - `location` string, nullable
      - `profile_image_url` string, nullable
      - `follower_count` integer, nullable
      - `connection_count` integer, nullable
      - `profile_views` integer, nullable
      - `status` string, nullable
      - `last_refreshed` string, date-time, nullable
      - `updated_at` string, date-time, nullable
    - `website` object
      - `url` string, nullable, required
      - `summary` string, nullable, required
      - `screenshot` AgentReferenceImage, required
        - `id` string, required
        - `creator_id` string, required
        - `url` string, nullable, required
        - `filename` string, nullable, required
        - `description` string, nullable, required
        - `reference_role` string, nullable, required
        - `is_primary` boolean, required
        - `is_active_for_likeness` boolean, required
        - `sort_order` integer, required
        - `notes` string, nullable, required
        - `created_at` string, date-time, nullable, required
    - `brand_kits` AgentBrandKitCollection
      - `creator_id` string, required
      - `brand_packs` AgentBrandPack[], required
        - `id` string, required
        - `creator_id` string, required
        - `pack_type` string, nullable, required
        - `name` string, nullable, required
        - `description` string, nullable, required
        - `is_default` boolean, required
        - `tags` unknown, required
        - `palette` unknown, required
        - `fonts` unknown, required
        - `visual_style_prompt` string, nullable, required
        - `brand_rules` string, nullable, required
        - `notes` string, nullable, required
        - `negative_prompt` string, nullable, required
        - `created_at` string, date-time, nullable, required
        - `updated_at` string, date-time, nullable, required
        - `assets` AgentBrandPackAsset[], required
          - `id` string, required
          - `brand_pack_id` string, required
          - `media_asset_id` string, nullable, required
          - `reference_image_id` string, nullable, required
          - `url` string, nullable, required
          - `asset_role` string, nullable, required
          - `sort_order` integer, required
          - `created_at` string, date-time, nullable, required
      - `brand_kit_projects` AgentBrandKitProject[], required
        - `id` string, required
        - `creator_id` string, required
        - `source` string, nullable, required
        - `status` string, nullable, required
        - `title` string, nullable, required
        - `brand_name` string, nullable, required
        - `website` string, nullable, required
        - `founder_name` string, nullable, required
        - `founder_title` string, nullable, required
        - `brand_positioning` string, nullable, required
        - `target_audience` string, nullable, required
        - `offer_category` string, nullable, required
        - `output_type` string, nullable, required
        - `number_of_pages` integer, required
        - `aspect_ratio` string, nullable, required
        - `output_size` string, nullable, required
        - `compiler_version` string, nullable, required
        - `style_reference_summary` unknown, required
        - `founder_likeness_summary` unknown, required
        - `creative_brief` unknown, required
        - `page_plan` unknown, required
        - `negative_constraints` unknown, required
        - `reference_manifest` unknown, required
        - `created_at` string, date-time, nullable, required
        - `updated_at` string, date-time, nullable, required
        - `pages` AgentBrandKitPage[], required
          - `id` string, required
          - `brand_kit_project_id` string, required
          - `media_asset_id` string, nullable, required
          - `page_number` integer, required
          - `page_title` string, nullable, required
          - `page_goal` string, nullable, required
          - `sections` unknown, required
          - `copy_blocks` unknown, required
          - `layout_direction` string, nullable, required
          - `image_url` string, nullable, required
          - `output_size` string, nullable, required
          - `aspect_ratio` string, nullable, required
          - `reference_manifest` unknown, required
          - `version` integer, required
          - `status` string, nullable, required
          - `created_at` string, date-time, nullable, required
          - `updated_at` string, date-time, nullable, required
    - `media` object
      - `reference_images` AgentReferenceImage[], required
        - `id` string, required
        - `creator_id` string, required
        - `url` string, nullable, required
        - `filename` string, nullable, required
        - `description` string, nullable, required
        - `reference_role` string, nullable, required
        - `is_primary` boolean, required
        - `is_active_for_likeness` boolean, required
        - `sort_order` integer, required
        - `notes` string, nullable, required
        - `created_at` string, date-time, nullable, required
      - `website_screenshots` AgentReferenceImage[], required
        - `id` string, required
        - `creator_id` string, required
        - `url` string, nullable, required
        - `filename` string, nullable, required
        - `description` string, nullable, required
        - `reference_role` string, nullable, required
        - `is_primary` boolean, required
        - `is_active_for_likeness` boolean, required
        - `sort_order` integer, required
        - `notes` string, nullable, required
        - `created_at` string, date-time, nullable, required
    - `page` object, required
      - `limit` integer, required
  - `receipt` unknown, required

## Other responses

- `400`: Invalid query
- `401`: Missing or invalid bearer token
- `403`: Creator or scope access denied
- `404`: Creator not found
- `500`: Creator context temporarily unavailable

---

[API](https://skmtc.dev/bamf/apis/bamf-developer-platform-api.md) · [All operations](https://skmtc.dev/bamf/apis/bamf-developer-platform-api/llms.txt) · [OpenAPI document](https://skmtc.dev/bamf/apis/bamf-developer-platform-api/revisions/a390dd3294bd?raw)
