Strategy API

Positioning, audience, content pillars, priorities and recommendations.

7 endpoints. Every path is relative to the API base URL and needs a bearer token unless it is marked public. See the REST API overview for authentication, errors and pagination.

GET/v1/orgs/{orgId}/strategy

Bearer tokenMCP tool: get_strategy

Get the active workspace strategy (canonical operating plan).

Path parameters

• orgIdstring (uuid)required

Responses

200Get the active workspace strategy (canonical operating plan).

• dataobject | nullrequired
  Fields

  • idstring (uuid)required
  • orgIdstring (uuid)required
  • versionintegerrequired
  • statusstringrequired

    one of draft, active, superseded

  • primaryObjectivestringrequired
  • targetAudiencestringrequired
  • pillarsarray<object>required
    Item fields

    • idstringrequired
    • namestringrequired
    • descriptionstring
    • priorityinteger
    • keywordsarray<string>
  • channelPrioritiesarray<object>required
    Item fields

    • platformstringrequired

      one of x, linkedin, tiktok, reddit, facebook, instagram, youtube, bluesky, threads

    • enabledboolean
    • priorityinteger
    • postsPerWeeknumber
  • contentMixarray<object>required
    Item fields

    • contentTypestringrequired

      one of educational, opinion, personal, community, promotional

    • targetPercentnumberrequired
  • metaobjectrequired
    Fields

    • schemaVersioninteger
    • generatedAtstring | null
    • confirmedAtstring | null
    • confirmedBystring (uuid) | null
    • lastEditedAtstring | null
    • lastSuggestedAtstring | null
  • createdAtstringrequired
  • updatedAtstringrequired
  • sourceGoalstring | null
  • positioningAnglesarray<string>
  • opportunitiesarray<object>
    Item fields

    • idstringrequired
    • themestringrequired
    • rationalestring
    • statusstring

      one of open, exploring, done, dismissed

  • prioritiesarray<object>
    Item fields

    • idstringrequired
    • textstringrequired
    • startsAtstringrequired
    • endsAtstring | null
    • statusstring

      one of active, expired, cancelled

    • createdAtstring
    • createdBystring (uuid) | null
  • guardrailNotesarray<string>
  • recommendationsarray<object>
    Item fields

    • idstringrequired
    • summarystringrequired
    • createdAtstringrequired
    • rationalestring
    • proposedChangestring
    • statusstring

      one of pending, accepted, rejected

  • confidencestring

    one of high, medium, low

Request

curl -X GET "https://api.adventur.ai/v1/orgs/$ORG_ID/strategy" \
  -H "Authorization: Bearer $ADVENTURAI_TOKEN"

PATCH/v1/orgs/{orgId}/strategy

Bearer token

Edit the active workspace strategy.

Path parameters

• orgIdstring (uuid)required

Request body application/json

• sourceGoalstring | null
• primaryObjectivestring
• targetAudiencestring
• pillarsarray<object>
  Item fields

  • namestringrequired
  • idstring
  • descriptionstring
  • priorityinteger
  • keywordsarray<string>
• channelPrioritiesarray<object>
  Item fields

  • platformstringrequired

    one of x, linkedin, tiktok, reddit, facebook, instagram, youtube, bluesky, threads

  • enabledboolean
  • priorityinteger
  • postsPerWeeknumber
• contentMixarray<object>
  Item fields

  • contentTypestringrequired

    one of educational, opinion, personal, community, promotional

  • targetPercentnumberrequired
• positioningAnglesarray<string>
• opportunitiesarray<object>
  Item fields

  • idstringrequired
  • themestringrequired
  • rationalestring
  • statusstring

    one of open, exploring, done, dismissed

• prioritiesarray<object>
  Item fields

  • idstringrequired
  • textstringrequired
  • startsAtstringrequired
  • endsAtstring | null
  • statusstring

    one of active, expired, cancelled

  • createdAtstring
  • createdBystring (uuid) | null
• guardrailNotesarray<string>
• recommendationsarray<object>
  Item fields

  • idstringrequired
  • summarystringrequired
  • createdAtstringrequired
  • rationalestring
  • proposedChangestring
  • statusstring

    one of pending, accepted, rejected

• confidencestring

  one of high, medium, low

Responses

200Edit the active workspace strategy.

• dataobjectrequired
  Fields

  • idstring (uuid)required
  • orgIdstring (uuid)required
  • versionintegerrequired
  • statusstringrequired

    one of draft, active, superseded

  • primaryObjectivestringrequired
  • targetAudiencestringrequired
  • pillarsarray<object>required
    Item fields

    • idstringrequired
    • namestringrequired
    • descriptionstring
    • priorityinteger
    • keywordsarray<string>
  • channelPrioritiesarray<object>required
    Item fields

    • platformstringrequired

      one of x, linkedin, tiktok, reddit, facebook, instagram, youtube, bluesky, threads

    • enabledboolean
    • priorityinteger
    • postsPerWeeknumber
  • contentMixarray<object>required
    Item fields

    • contentTypestringrequired

      one of educational, opinion, personal, community, promotional

    • targetPercentnumberrequired
  • metaobjectrequired
    Fields

    • schemaVersioninteger
    • generatedAtstring | null
    • confirmedAtstring | null
    • confirmedBystring (uuid) | null
    • lastEditedAtstring | null
    • lastSuggestedAtstring | null
  • createdAtstringrequired
  • updatedAtstringrequired
  • sourceGoalstring | null
  • positioningAnglesarray<string>
  • opportunitiesarray<object>
    Item fields

    • idstringrequired
    • themestringrequired
    • rationalestring
    • statusstring

      one of open, exploring, done, dismissed

  • prioritiesarray<object>
    Item fields

    • idstringrequired
    • textstringrequired
    • startsAtstringrequired
    • endsAtstring | null
    • statusstring

      one of active, expired, cancelled

    • createdAtstring
    • createdBystring (uuid) | null
  • guardrailNotesarray<string>
  • recommendationsarray<object>
    Item fields

    • idstringrequired
    • summarystringrequired
    • createdAtstringrequired
    • rationalestring
    • proposedChangestring
    • statusstring

      one of pending, accepted, rejected

  • confidencestring

    one of high, medium, low

Request

curl -X PATCH "https://api.adventur.ai/v1/orgs/$ORG_ID/strategy" \
  -H "Authorization: Bearer $ADVENTURAI_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

POST/v1/orgs/{orgId}/strategy/confirm

Bearer token

Confirm the active strategy (optionally applying edits).

Path parameters

• orgIdstring (uuid)required

Request body application/json

• updatesobject
  Fields

  • sourceGoalstring | null
  • primaryObjectivestring
  • targetAudiencestring
  • pillarsarray<object>
    Item fields

    • namestringrequired
    • idstring
    • descriptionstring
    • priorityinteger
    • keywordsarray<string>
  • channelPrioritiesarray<object>
    Item fields

    • platformstringrequired

      one of x, linkedin, tiktok, reddit, facebook, instagram, youtube, bluesky, threads

    • enabledboolean
    • priorityinteger
    • postsPerWeeknumber
  • contentMixarray<object>
    Item fields

    • contentTypestringrequired

      one of educational, opinion, personal, community, promotional

    • targetPercentnumberrequired
  • positioningAnglesarray<string>
  • opportunitiesarray<object>
    Item fields

    • idstringrequired
    • themestringrequired
    • rationalestring
    • statusstring

      one of open, exploring, done, dismissed

  • prioritiesarray<object>
    Item fields

    • idstringrequired
    • textstringrequired
    • startsAtstringrequired
    • endsAtstring | null
    • statusstring

      one of active, expired, cancelled

    • createdAtstring
    • createdBystring (uuid) | null
  • guardrailNotesarray<string>
  • recommendationsarray<object>
    Item fields

    • idstringrequired
    • summarystringrequired
    • createdAtstringrequired
    • rationalestring
    • proposedChangestring
    • statusstring

      one of pending, accepted, rejected

  • confidencestring

    one of high, medium, low

Responses

200Confirm the active strategy (optionally applying edits).

• dataobjectrequired
  Fields

  • idstring (uuid)required
  • orgIdstring (uuid)required
  • versionintegerrequired
  • statusstringrequired

    one of draft, active, superseded

  • primaryObjectivestringrequired
  • targetAudiencestringrequired
  • pillarsarray<object>required
    Item fields

    • idstringrequired
    • namestringrequired
    • descriptionstring
    • priorityinteger
    • keywordsarray<string>
  • channelPrioritiesarray<object>required
    Item fields

    • platformstringrequired

      one of x, linkedin, tiktok, reddit, facebook, instagram, youtube, bluesky, threads

    • enabledboolean
    • priorityinteger
    • postsPerWeeknumber
  • contentMixarray<object>required
    Item fields

    • contentTypestringrequired

      one of educational, opinion, personal, community, promotional

    • targetPercentnumberrequired
  • metaobjectrequired
    Fields

    • schemaVersioninteger
    • generatedAtstring | null
    • confirmedAtstring | null
    • confirmedBystring (uuid) | null
    • lastEditedAtstring | null
    • lastSuggestedAtstring | null
  • createdAtstringrequired
  • updatedAtstringrequired
  • sourceGoalstring | null
  • positioningAnglesarray<string>
  • opportunitiesarray<object>
    Item fields

    • idstringrequired
    • themestringrequired
    • rationalestring
    • statusstring

      one of open, exploring, done, dismissed

  • prioritiesarray<object>
    Item fields

    • idstringrequired
    • textstringrequired
    • startsAtstringrequired
    • endsAtstring | null
    • statusstring

      one of active, expired, cancelled

    • createdAtstring
    • createdBystring (uuid) | null
  • guardrailNotesarray<string>
  • recommendationsarray<object>
    Item fields

    • idstringrequired
    • summarystringrequired
    • createdAtstringrequired
    • rationalestring
    • proposedChangestring
    • statusstring

      one of pending, accepted, rejected

  • confidencestring

    one of high, medium, low

Request

curl -X POST "https://api.adventur.ai/v1/orgs/$ORG_ID/strategy/confirm" \
  -H "Authorization: Bearer $ADVENTURAI_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

POST/v1/orgs/{orgId}/strategy/generate

Bearer token

Generate an AI-proposed strategy from goal + brand context.

Path parameters

• orgIdstring (uuid)required

Request body application/json

• goalstring
• replaceActiveboolean

Responses

200Generate an AI-proposed strategy from goal + brand context.

• dataobjectrequired
  Fields

  • idstring (uuid)required
  • orgIdstring (uuid)required
  • versionintegerrequired
  • statusstringrequired

    one of draft, active, superseded

  • primaryObjectivestringrequired
  • targetAudiencestringrequired
  • pillarsarray<object>required
    Item fields

    • idstringrequired
    • namestringrequired
    • descriptionstring
    • priorityinteger
    • keywordsarray<string>
  • channelPrioritiesarray<object>required
    Item fields

    • platformstringrequired

      one of x, linkedin, tiktok, reddit, facebook, instagram, youtube, bluesky, threads

    • enabledboolean
    • priorityinteger
    • postsPerWeeknumber
  • contentMixarray<object>required
    Item fields

    • contentTypestringrequired

      one of educational, opinion, personal, community, promotional

    • targetPercentnumberrequired
  • metaobjectrequired
    Fields

    • schemaVersioninteger
    • generatedAtstring | null
    • confirmedAtstring | null
    • confirmedBystring (uuid) | null
    • lastEditedAtstring | null
    • lastSuggestedAtstring | null
  • createdAtstringrequired
  • updatedAtstringrequired
  • sourceGoalstring | null
  • positioningAnglesarray<string>
  • opportunitiesarray<object>
    Item fields

    • idstringrequired
    • themestringrequired
    • rationalestring
    • statusstring

      one of open, exploring, done, dismissed

  • prioritiesarray<object>
    Item fields

    • idstringrequired
    • textstringrequired
    • startsAtstringrequired
    • endsAtstring | null
    • statusstring

      one of active, expired, cancelled

    • createdAtstring
    • createdBystring (uuid) | null
  • guardrailNotesarray<string>
  • recommendationsarray<object>
    Item fields

    • idstringrequired
    • summarystringrequired
    • createdAtstringrequired
    • rationalestring
    • proposedChangestring
    • statusstring

      one of pending, accepted, rejected

  • confidencestring

    one of high, medium, low

Request

curl -X POST "https://api.adventur.ai/v1/orgs/$ORG_ID/strategy/generate" \
  -H "Authorization: Bearer $ADVENTURAI_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

POST/v1/orgs/{orgId}/strategy/priorities

Bearer token

Add a time-bounded campaign priority to the active strategy.

Path parameters

• orgIdstring (uuid)required

Request body application/json

• textstringrequired
• startsAtstring
• endsAtstring | null

Responses

200Add a time-bounded campaign priority to the active strategy.

• dataobjectrequired
  Fields

  • idstring (uuid)required
  • orgIdstring (uuid)required
  • versionintegerrequired
  • statusstringrequired

    one of draft, active, superseded

  • primaryObjectivestringrequired
  • targetAudiencestringrequired
  • pillarsarray<object>required
    Item fields

    • idstringrequired
    • namestringrequired
    • descriptionstring
    • priorityinteger
    • keywordsarray<string>
  • channelPrioritiesarray<object>required
    Item fields

    • platformstringrequired

      one of x, linkedin, tiktok, reddit, facebook, instagram, youtube, bluesky, threads

    • enabledboolean
    • priorityinteger
    • postsPerWeeknumber
  • contentMixarray<object>required
    Item fields

    • contentTypestringrequired

      one of educational, opinion, personal, community, promotional

    • targetPercentnumberrequired
  • metaobjectrequired
    Fields

    • schemaVersioninteger
    • generatedAtstring | null
    • confirmedAtstring | null
    • confirmedBystring (uuid) | null
    • lastEditedAtstring | null
    • lastSuggestedAtstring | null
  • createdAtstringrequired
  • updatedAtstringrequired
  • sourceGoalstring | null
  • positioningAnglesarray<string>
  • opportunitiesarray<object>
    Item fields

    • idstringrequired
    • themestringrequired
    • rationalestring
    • statusstring

      one of open, exploring, done, dismissed

  • prioritiesarray<object>
    Item fields

    • idstringrequired
    • textstringrequired
    • startsAtstringrequired
    • endsAtstring | null
    • statusstring

      one of active, expired, cancelled

    • createdAtstring
    • createdBystring (uuid) | null
  • guardrailNotesarray<string>
  • recommendationsarray<object>
    Item fields

    • idstringrequired
    • summarystringrequired
    • createdAtstringrequired
    • rationalestring
    • proposedChangestring
    • statusstring

      one of pending, accepted, rejected

  • confidencestring

    one of high, medium, low

Request

curl -X POST "https://api.adventur.ai/v1/orgs/$ORG_ID/strategy/priorities" \
  -H "Authorization: Bearer $ADVENTURAI_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"text":"string"}'

PATCH/v1/orgs/{orgId}/strategy/priorities/{priorityId}

Bearer token

Update or expire a temporary strategy priority.

Path parameters

• orgIdstring (uuid)required
• priorityIdstringrequired

Request body application/json

• textstring
• startsAtstring
• endsAtstring | null
• statusstring

  one of active, expired, cancelled

Responses

200Update or expire a temporary strategy priority.

• dataobjectrequired
  Fields

  • idstring (uuid)required
  • orgIdstring (uuid)required
  • versionintegerrequired
  • statusstringrequired

    one of draft, active, superseded

  • primaryObjectivestringrequired
  • targetAudiencestringrequired
  • pillarsarray<object>required
    Item fields

    • idstringrequired
    • namestringrequired
    • descriptionstring
    • priorityinteger
    • keywordsarray<string>
  • channelPrioritiesarray<object>required
    Item fields

    • platformstringrequired

      one of x, linkedin, tiktok, reddit, facebook, instagram, youtube, bluesky, threads

    • enabledboolean
    • priorityinteger
    • postsPerWeeknumber
  • contentMixarray<object>required
    Item fields

    • contentTypestringrequired

      one of educational, opinion, personal, community, promotional

    • targetPercentnumberrequired
  • metaobjectrequired
    Fields

    • schemaVersioninteger
    • generatedAtstring | null
    • confirmedAtstring | null
    • confirmedBystring (uuid) | null
    • lastEditedAtstring | null
    • lastSuggestedAtstring | null
  • createdAtstringrequired
  • updatedAtstringrequired
  • sourceGoalstring | null
  • positioningAnglesarray<string>
  • opportunitiesarray<object>
    Item fields

    • idstringrequired
    • themestringrequired
    • rationalestring
    • statusstring

      one of open, exploring, done, dismissed

  • prioritiesarray<object>
    Item fields

    • idstringrequired
    • textstringrequired
    • startsAtstringrequired
    • endsAtstring | null
    • statusstring

      one of active, expired, cancelled

    • createdAtstring
    • createdBystring (uuid) | null
  • guardrailNotesarray<string>
  • recommendationsarray<object>
    Item fields

    • idstringrequired
    • summarystringrequired
    • createdAtstringrequired
    • rationalestring
    • proposedChangestring
    • statusstring

      one of pending, accepted, rejected

  • confidencestring

    one of high, medium, low

Request

curl -X PATCH "https://api.adventur.ai/v1/orgs/$ORG_ID/strategy/priorities/$PRIORITY_ID" \
  -H "Authorization: Bearer $ADVENTURAI_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

POST/v1/orgs/{orgId}/strategy/recommendations/{recommendationId}

Bearer token

Accept or reject a suggested strategy change.

Path parameters

• orgIdstring (uuid)required
• recommendationIdstringrequired

Request body application/json

• decisionstringrequired

  one of accepted, rejected

Responses

200Accept or reject a suggested strategy change.

• dataobjectrequired
  Fields

  • idstring (uuid)required
  • orgIdstring (uuid)required
  • versionintegerrequired
  • statusstringrequired

    one of draft, active, superseded

  • primaryObjectivestringrequired
  • targetAudiencestringrequired
  • pillarsarray<object>required
    Item fields

    • idstringrequired
    • namestringrequired
    • descriptionstring
    • priorityinteger
    • keywordsarray<string>
  • channelPrioritiesarray<object>required
    Item fields

    • platformstringrequired

      one of x, linkedin, tiktok, reddit, facebook, instagram, youtube, bluesky, threads

    • enabledboolean
    • priorityinteger
    • postsPerWeeknumber
  • contentMixarray<object>required
    Item fields

    • contentTypestringrequired

      one of educational, opinion, personal, community, promotional

    • targetPercentnumberrequired
  • metaobjectrequired
    Fields

    • schemaVersioninteger
    • generatedAtstring | null
    • confirmedAtstring | null
    • confirmedBystring (uuid) | null
    • lastEditedAtstring | null
    • lastSuggestedAtstring | null
  • createdAtstringrequired
  • updatedAtstringrequired
  • sourceGoalstring | null
  • positioningAnglesarray<string>
  • opportunitiesarray<object>
    Item fields

    • idstringrequired
    • themestringrequired
    • rationalestring
    • statusstring

      one of open, exploring, done, dismissed

  • prioritiesarray<object>
    Item fields

    • idstringrequired
    • textstringrequired
    • startsAtstringrequired
    • endsAtstring | null
    • statusstring

      one of active, expired, cancelled

    • createdAtstring
    • createdBystring (uuid) | null
  • guardrailNotesarray<string>
  • recommendationsarray<object>
    Item fields

    • idstringrequired
    • summarystringrequired
    • createdAtstringrequired
    • rationalestring
    • proposedChangestring
    • statusstring

      one of pending, accepted, rejected

  • confidencestring

    one of high, medium, low

Request

curl -X POST "https://api.adventur.ai/v1/orgs/$ORG_ID/strategy/recommendations/$RECOMMENDATION_ID" \
  -H "Authorization: Bearer $ADVENTURAI_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"decision":"accepted"}'