Owned content#
See how an AI assistant can help with owned content in Brandwave, including example prompts and the details it may ask for.
Using your AI assistant
List owned content#
List the owned content on your site, such as a blog or guides section, with the URL paths that define each one, its job and when it started.
Tool name: list_owned_content. Protocol hints: readOnlyHint=true, destructiveHint=false, idempotentHint=true, openWorldHint=false.
Example prompt#
List all owned content in my workspace.Details to provide#
| Name | Type | Required | Description |
|---|---|---|---|
| workspaceId | string (UUID) | Required | Workspace identifier. |
What you'll get back#
Returns { items, totalCount, facets, _meta } with paginated results.
Get owned content performance#
Retrieve how each piece of owned content did, month by month: Google search impressions and clicks for its pages, clicks from searches that named your brand, visits that started on it, and the success metric and interest actions in those visits. Search Console leaves rare searches out of query-level figures, so branded clicks are a lower bound, and success metric counts from GA4 are a rough guide. 12 calendar months by default (3-24).
Tool name: get_owned_content_performance. Protocol hints: readOnlyHint=true, destructiveHint=false, idempotentHint=true, openWorldHint=false.
Example prompt#
Show me the details for this owned content performance.Details to provide#
| Name | Type | Required | Description |
|---|---|---|---|
| workspaceId | string (UUID) | Required | Workspace identifier. |
| endDate | string | Required | Last day to include (YYYY-MM-DD), usually today. Months run to the end of this date’s month. |
| months | integer | — | Calendar months to return, oldest first (3-24, default 12). |
What you'll get back#
Returns { data, _meta } with the result.
Add owned content#
Add a part of your own site to track as owned content, such as a blog at /blog, by name and URL paths. Its job is Be findable unless you choose another. Search and visit history is fetched automatically.
Tool name: create_owned_content. Protocol hints: readOnlyHint=false, destructiveHint=false, idempotentHint=false, openWorldHint=false.
Example prompt#
Create a new add owned content.Details to provide#
| Name | Type | Required | Description |
|---|---|---|---|
| workspaceId | string (UUID) | Required | Workspace identifier. |
| name | string | Required | What you call this content, such as "Blog" or "Help centre". |
| paths | Array<string> | Required | The paths that make up this content, such as ["/blog", "/guides"]. |
| job | 'build' | 'findable' | 'convert' | — | Its job. Be findable (findable) unless you say otherwise. |
| runningSince | string | null | — | When you started publishing it (YYYY-MM-DD), or null when you are not sure. |
What you'll get back#
Returns { data, _meta } with the result.
Update owned content#
Update owned content's name, URL paths, job or start date. Changing the paths fetches its search and visit history again.
Tool name: update_owned_content. Protocol hints: readOnlyHint=false, destructiveHint=true, idempotentHint=true, openWorldHint=false.
Example prompt#
Update the owned content.Details to provide#
| Name | Type | Required | Description |
|---|---|---|---|
| id | string (UUID) | Required | Unique identifier (UUID v4). |
| name | string | — | What you call this content, such as "Blog" or "Help centre". |
| paths | Array<string> | — | Replaces every path. Changing them refetches the content’s search and visit history. |
| job | 'build' | 'findable' | 'convert' | — | build: more of the right people know and remember you, judged by interest over months (TV, radio, outdoor, PR, your own posts). findable: you show up when someone looks for what you do (content, listings, review sites, backlinks). convert: nudges people who already know you, judged by direct evidence within weeks (paid media, in-person events, partnerships, offers). |
| runningSince | string | null | — | When you started publishing it (YYYY-MM-DD), or null when you are not sure. |
What you'll get back#
Returns { data, _meta } with the result.
Remove owned content#
Remove a part of your site from owned content so Brandwave stops tracking it.
Tool name: delete_owned_content. Protocol hints: readOnlyHint=false, destructiveHint=true, idempotentHint=true, openWorldHint=false.
Example prompt#
Delete this remove owned content.Details to provide#
| Name | Type | Required | Description |
|---|---|---|---|
| id | string (UUID) | Required | Unique identifier (UUID v4). |
What you'll get back#
Returns { data, _meta } with the result.