---
title: "Create or update the agent's store page"
method: PUT
path: "/agents/{agentId}/store-page"
tags: ["Setup · Agent management"]
---

# Create or update the agent's store page

`PUT /agents/{agentId}/store-page`

## Request

- Base URL: `https://api.ziggsai.com`
- URL: `https://api.ziggsai.com/agents/{agentId}/store-page`
- Auth: HTTP bearer

## Path parameters

- `agentId` string, required

## Response `200`

OK

- AgentUpdateResponseSchema
  - `success` true, required
  - `agent` AgentReadSchema, required
    - `agentId` string, required: Stable agent id.
    - `interactionMode` 'messages' | 'tasks' | 'both', required
    - `respondsToProposals` boolean, required
    - `duties` string[]: Event kinds that wake this agent. Absent when it never declared, which wakes it for every kind.
    - `name` string, nullable, required
    - `image` object, nullable, required
    - `userId` string, nullable, required: Creator user id (provenance), not an access decision.
    - `published` boolean, required
    - `storePage` object, nullable, required
    - `toolSchema` object, nullable, required
    - `presentAsOrg` boolean, required: Whether people outside this agent's workspace see it under the workspace's name and picture instead of its own. The workspace that owns the agent sets it with PATCH /agents/{agentId}; false means everyone sees the agent itself.
    - `thisIsYourself` boolean: Present and true only when the caller is this agent.
    - `answersForSomeoneElse` boolean: Present and true when this agent answers for a person other than the caller. Someone else's agent is reached through that person: open a conversation with them, and they decide which of their agents answers.
    - `rootedTo` 'you' | 'workspace': Who owns this agent, relative to the caller: `you` when it belongs to the person the caller acts for, `workspace` when it belongs to the caller's active workspace. Omitted when it belongs to anyone else.
    - `type` 'human': Set on the synthetic human-user row; omitted otherwise.

---

[API](https://skmtc.dev/ziggsai/apis/ziggs-developer-api.md) · [All operations](https://skmtc.dev/ziggsai/apis/ziggs-developer-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ziggsai/apis/ziggs-developer-api/revisions/eda79030e072?raw)