Skip to main content
When a buyer asks your storefront for proposals, a brain composes the answer from your Library: your products, prices, playbook and rules. You choose which brain that is: You can also run a second brain in shadow mode. A shadow brain gets the same requests under the same rules, and its proposals are checked and recorded, but never shown to a buyer. Use it to see how another brain would have answered your real briefs before you switch. Once shadow brains run, they run at no charge during the beta.
Apostra does not yet send requests to any brain but Chef. Until it does, Chef answers every request, and no shadow brain runs, whatever this setting says. The setting is saved and recorded now, so your choice takes effect, for new requests, once Apostra can send them to the brain you chose.
Choosing a brain is in beta. If get(kind: "seller") returns no proposalAgent, your account is not on the beta.

​
Who can change it

Only a direct administrator of your organization, signed in as themselves, can choose the brain. A call from any agent, including your own, or from a staff member impersonating someone, is refused: who answers your buyers is your decision. The account must sell as a Storefront. A Listing has no brain to choose, because Apostra does not answer its buyers’ proposal requests (see Change a Seller Account’s type).

​
Read the setting

get(kind: "seller") returns proposalAgent:

​
Change it

Send the whole setting with save_seller, on its own, with the updatedAt you read:
  • expectedUpdatedAt is required. Send the updatedAt you read, or null while the setting was never saved. If someone saved a change since you read it, the call is refused with CONFLICT and names the setting now in force, so two administrators never overwrite each other.
  • shadow must differ from answering.
  • ownAgentId is required when answering or shadow is own, and must be null otherwise. It must be a proposal agent your organization connected and verified as its own.
  • Your own proposal agent is not open to sellers yet, as answering or shadow. It opens when the choice of brain launches to sellers. Until then own is refused with FEATURE_NOT_ENABLED and reason: "own_proposal_agent_unavailable", and only Apostra’s own accounts can choose it.
  • Saving the setting already in force changes nothing.
Once Apostra sends requests to the brain you chose, a change applies to new requests. A negotiation that is already open finishes with the brain that opened it, so a buyer partway through a negotiation never sees the answering brain change under them. Every change is recorded with the administrator who made it.

​
Prime is not available yet

Prime needs your Seller account to have its own agent, which Apostra does not offer yet. Until it does, prime is refused, as answering or shadow, with VALIDATION_ERROR and reason: "seller_agent_unavailable".

​
Refusals