Save a profile's brief

Save a new version of the profile's brief. Omitted fields keep the current values; the first brief needs role_title and timezone. Every product, persona, ICP and voice sample named must belong to this workspace.

PATCHhttps://app.trygtm.com/api/v1/linkedin/profiles/{profile_id}/brief

Scope: write
MCP tool: save_linkedin_brief

Path parameters

profile_idstringrequired: The managed profile's id, from list_linkedin_profiles.

Headers

Idempotency-Keystringoptional: A key unique to this write, up to 255 characters. A retry carrying the same key returns the first response instead of running again. Kept for 24 hours.

Body

primary_product_idstring | nulloptional: The product or service the profile is built around, from this workspace's Context.
secondary_product_idsstring[]optional: Other products it may mention. Replaces the current list.
persona_idsstring[]optional: The buyer personas it speaks to. Replaces the current list.
icp_idstring | nulloptional: The ideal customer profile it speaks to.
role_titlestringoptional: What the person actually does, in their words. Never invented from the product.
positioningstring | nulloptional: How the person wants to be known.
call_to_actionstring | nulloptional: The next step the profile invites.
voice_notesstring | nulloptional: How the person writes.
voice_sample_source_idsstring[]optional: Voice samples from this profile's sources. Replaces the current list.
avoid_topicsstring[]optional: Topics never to raise. Replaces the current list.
naming_policystringoptional: Whether customers may be named: only with permission, anonymized, or never.name_with_permissionanonymizenever
cadence_per_weekintegeroptional: How many posts a week automatic drafting prepares, 0 to 7.
timezonestringoptional: The IANA time zone times are shown in, e.g. America/Chicago.
monthly_credit_capintegeroptional: The most credits preparing this profile's content may spend in a month.

Request

curl -X PATCH https://app.trygtm.com/api/v1/linkedin/profiles/8f2a91c4-6d1e-4c0a-9a57-2f3b1c7e9d10/brief \
  -H "Authorization: Bearer $TRYGTM_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "icp_id": "f0e1d2c3-b4a5-4697-8877-66554433aa11"
  }'

Response

{
  "data": {
    "brief": {
      "id": "3c4d5e6f-7a8b-4c9d-8e0f-1a2b3c4d5e6f",
      "version": 2,
      "primary_product_id": "7a8b9c0d-1e2f-4a3b-8c4d-5e6f7a8b9c0d",
      "secondary_product_ids": [],
      "persona_ids": [],
      "icp_id": null,
      "role_title": "Head of Growth",
      "positioning": null,
      "call_to_action": "Book a walkthrough",
      "voice_notes": null,
      "voice_sample_source_ids": [],
      "avoid_topics": [
        "pricing"
      ],
      "naming_policy": "anonymize",
      "cadence_per_week": 2,
      "timezone": "America/Chicago",
      "monthly_credit_cap": 300,
      "created_at": "2026-09-28T15:00:00.000Z"
    },
    "profile_path": "/linkedin/6b1f2e3d-4c5a-4b6c-8d7e-9f0a1b2c3d4e"
  }
}