> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apostra.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Management UI

> Navigate Apostra platform dashboard to manage members, API keys, advertisers, partners, and billing

Apostra platform provides a web dashboard at [app.apostra.com](https://app.apostra.com) for managing your organization's members, API keys, advertisers, partners, and billing.

## Apostra assistant

The product assistant is moving from **Murph** to **Apostra**. During the staged
rollout, your account may still show Murph until Apostra branding is enabled for
you. Once enabled, the assistant and its calls to action use Apostra, including
**Ask Apostra**.

New links use `/{customerId}/apostra`, including
`/{customerId}/apostra/c/{conversationUid}` for a conversation. Existing
`/murph` bookmarks and shared conversation links continue to work: Apostra
redirects them to the matching new route without dropping supported page
filters or the conversation ID. You do not need to update existing links.

<Note>
  API and agent integrations keep their current compatibility identifiers during
  this rollout. Continue to use `/api/v2/murph`, `/mcp/v2/murph`, and the
  `ask_murph` tool. A future identifier change will use an additive alias and a
  published deprecation period.
</Note>

### Dictate a message

Select the microphone in the message box, speak, then select it again to stop.
The assistant turns your speech into text and places it in the message box at
your cursor, so you can check and edit it first. Nothing goes to the assistant
until you send the message.

* A recording stops on its own after two minutes and is transcribed.
* If the recording has no speech in it, such as silence or background noise,
  nothing is added to your message and you see a "no speech" notice. Speak at
  a normal level close to your microphone.
* The first time, your browser asks for permission to use the microphone. If
  you block it, allow microphone access for the Apostra site in your browser
  settings to use dictation.
* The microphone appears only in browsers that can record audio.
* Dictation is unavailable once you reach your daily usage limit, until it resets.

**What happens to your recording.** The recording is sent to Apostra and
transcribed by Google Cloud Speech-to-Text in the United States. Apostra does not
store the recording. Only the text you choose to send becomes part of the
conversation. To spell names correctly, the transcription request includes the
names of your account's own advertisers, campaigns and storefront, along with
common advertising terms, as spelling hints. Names from one account are never
used for another account. Transcription uses the language you chat with the
assistant in.

## Account Switcher

If you belong to multiple accounts (for example, a Buyer account and a Seller account), use the account selector in the top-right corner to move between them. It also appears when you have a pending account invitation. A standalone account with no invitation or other account to reach does not show a redundant selector.

For organizations with the new settings group, the selector lists switchable accounts and pending invitations. Organization administrators add, archive, and restore child accounts in **Account settings → Organization → Accounts**. Organization members and billing details are in the adjacent panes. Until that group is available, the existing organization controls remain in the selector.

***

## Buyer Homepage

After logging in as a **Buyer**, you'll see the buyer homepage with quick-access cards for campaigns, advertisers, API keys, and member management.

<img src="https://mintcdn.com/agentic2/N0CVkbbjP1s-vSVR/images/ui-guide/buyer-homepage.png?fit=max&auto=format&n=N0CVkbbjP1s-vSVR&q=85&s=3e1210e10e9a9e027e6f8fb4fd661669" alt="Buyer homepage" width="1252" height="980" data-path="images/ui-guide/buyer-homepage.png" />

From here you can:

* **Get started** with documentation and quickstart guides
* **View reporting** for campaigns and media buys
* **Manage creatives** for your campaigns
* **Manage advertisers** for your organization
* **Manage API keys** for your integrations
* **Manage members** and permissions

***

## Seller Homepage

After logging in as a **Seller**, you'll see the seller homepage with quick-access cards for your storefront, campaigns, API keys, and member management.

<img src="https://mintcdn.com/agentic2/N0CVkbbjP1s-vSVR/images/ui-guide/seller-homepage.png?fit=max&auto=format&n=N0CVkbbjP1s-vSVR&q=85&s=27f7ba34a8c40d4c0aa13bd4ebe97e4f" alt="Seller homepage" width="1254" height="1062" data-path="images/ui-guide/seller-homepage.png" />

From here you can:

* **Get started** with documentation and quickstart guides
* **View your storefront** and manage products and inventory
* **View reporting** for campaigns and media buys
* **Manage API keys** for your integrations
* **Manage members** and permissions

***

## API Keys

Click **Manage API keys** from the dashboard to view your existing keys.

<img src="https://mintcdn.com/agentic2/LRWAIZYikOox6plT/images/ui-guide/api-keys.png?fit=max&auto=format&n=LRWAIZYikOox6plT&q=85&s=c0890f9d2ba9ff1412004338a4bfb3b8" alt="API Keys page" width="3030" height="936" data-path="images/ui-guide/api-keys.png" />

The primary list contains your keys. For organization administrators, it contains
user-owned keys across the organization so an admin can inspect their access levels
and revoke them. Each key acts as its owner: it follows that person's account and
resource access, while its selected `interchange:read`, `interchange:write`, or
`interchange:admin` access level can narrow what the integration may do. Account
administrators also see existing account-owned and legacy keys in separate migration
sections.

### Creating an API Key

Click **+ Create API Key** to open the creation form.

<img src="https://mintcdn.com/agentic2/LRWAIZYikOox6plT/images/ui-guide/create-api-key.png?fit=max&auto=format&n=LRWAIZYikOox6plT&q=85&s=1ee5b5d006f75d345f8024642fb6c514" alt="Create API Key form" style={{ maxWidth: '400px' }} width="1174" height="1116" data-path="images/ui-guide/create-api-key.png" />

Fill in the following fields:

| Field | Required | Description |
| - | - | - |
| **Name** | Yes | A descriptive name for the key |
| **Description** | No | Additional context about the key's purpose |
| **Expiration Date** | No | Optional expiry date (max 1 year from today). Leave empty for no expiration |

<Warning>
  The API key secret will be shown after creation. Store it securely - you'll need it to authenticate API and MCP requests.
</Warning>

For durable shared automation, create a dedicated service user, assign that user only
the accounts and resources the integration needs, and create the key as that user.

***

## Advertisers

Click **Manage advertisers** from the dashboard to view and manage advertiser accounts.

<img src="https://mintcdn.com/agentic2/USiDJ-ES1NJ7GkZ6/images/ui-guide/advertisers.png?fit=max&auto=format&n=USiDJ-ES1NJ7GkZ6&q=85&s=71aaae727f45233bcfa0efb3e0bb53ff" alt="Advertisers page" width="3034" height="888" data-path="images/ui-guide/advertisers.png" />

The advertiser list shows each advertiser's name, brand domain, description, status, and creation date. Use the three-dot menu on each row to manage individual advertisers.

### Creating an Advertiser

Click **+ Create advertiser** to open the creation form.

<img src="https://mintcdn.com/agentic2/LRWAIZYikOox6plT/images/ui-guide/create-advertiser.png?fit=max&auto=format&n=LRWAIZYikOox6plT&q=85&s=7fde7ef8049bbca03b9d7a1370c8ea10" alt="Create Advertiser form" style={{ maxWidth: '400px' }} width="1148" height="894" data-path="images/ui-guide/create-advertiser.png" />

| Field | Required | Description |
| - | - | - |
| **Name** | Yes | The advertiser's name |
| **Brand domain** | Yes | The advertiser's brand domain. Use **Look up brand** to resolve and link the brand from the domain. |
| **Primary currency** | Yes | The currency every campaign under this advertiser spends in. You can change it until the first campaign is created, after which it is locked. |
| **Description** | No | Additional context about the advertiser |
| **Sandbox mode** | No | Routes the advertiser's operations to sandbox accounts — no real platform calls or spend. Cannot be changed after creation. |

#### Adding an advertiser in chat

You can also add an advertiser without leaving the chat: ask the assistant (for example, *"add an advertiser called Acme at acme.com"*) or click **+ Add advertiser** on the Advertisers overview. A guided in-chat form opens — pre-filled with anything you already said — capturing the same fields above, resolving the brand for confirmation, and creating the advertiser when you submit. Once it's created you can switch straight into it or add another.

#### Media Company advertiser setup

In a Media Company account, select **Add advertiser** from Advertisers or
Campaigns to open the same guided form. Sandbox is available to every Media
Company and makes no real platform calls or spend. Accounts enrolled for live
campaign management can explicitly choose **Live**; other accounts see Sandbox
only. After creation, the roster refreshes before you switch into the new
advertiser.

***

## Member Management

Click **Manage members** from the dashboard to view and manage your organization's members.

<img src="https://mintcdn.com/agentic2/LRWAIZYikOox6plT/images/ui-guide/member-management.png?fit=max&auto=format&n=LRWAIZYikOox6plT&q=85&s=0ac9dc57484eb0c861b0cea23cbe1d15" alt="Member management page" width="3038" height="780" data-path="images/ui-guide/member-management.png" />

The member list shows each user's name or email, role, number of assigned advertisers and partners, and their status. Pending invitations show as "Invitation sent" in the Date Created column. You can search for members and change their role using the dropdown in the Role column.

### Inviting Members

Click **Invite members** to add new users to your organization.

**Step 1: Enter email and role**

<img src="https://mintcdn.com/agentic2/LRWAIZYikOox6plT/images/ui-guide/invite-members-step1.png?fit=max&auto=format&n=LRWAIZYikOox6plT&q=85&s=b0bd4fe7c32e1bd5d0f7aa134d8adf8e" alt="Invite members - email and role" style={{ maxWidth: '500px' }} width="1580" height="664" data-path="images/ui-guide/invite-members-step1.png" />

* Enter one or more email addresses
* Select an **Access role**:
  * **Admin** - Full access to all Advertisers and Partners by default. Advertiser selection in the following step is optional.
  * **Member** - Limited access. You must assign specific Advertisers and Partners in the next step.

**Step 2: Select access**

<img src="https://mintcdn.com/agentic2/LRWAIZYikOox6plT/images/ui-guide/invite-members-step2.png?fit=max&auto=format&n=LRWAIZYikOox6plT&q=85&s=8aba2ae5a1df50129563493803158163" alt="Invite members - select access" style={{ maxWidth: '500px' }} width="1572" height="758" data-path="images/ui-guide/invite-members-step2.png" />

Select which **Advertisers** and **Partners** the new member should have access to. For Admin users this step is optional since they have access to everything by default. Click **Send** to send the invitation.

***

## Next Steps

<CardGroup cols={2}>
  <Card title="Authentication" href="/v2/authentication" icon="key">
    Learn how to use your API key to authenticate requests
  </Card>

  <Card title="Quick Start" href="/v2/quickstart" icon="rocket">
    Get started making API calls with your key
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.