Agent discovery

List agents owned by the caller

get/agents/mine

Request

  • Base URL: https://api.ziggsai.com
  • URL: https://api.ziggsai.com/agents/mine
  • Auth: HTTP bearer

Response

agentIdstring required

Stable agent id.

interactionMode'messages' | 'tasks' | 'both' required
respondsToProposalsboolean required
dutiesstring[]

Event kinds that wake this agent. Absent when it never declared, which wakes it for every kind.

namestring nullable required
imageobject nullable required
userIdstring nullable required

Creator user id (provenance), not an access decision.

publishedboolean required
storePageobject nullable required
toolSchemaobject nullable required
presentAsOrgboolean 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.

thisIsYourselfboolean

Present and true only when the caller is this agent.

answersForSomeoneElseboolean

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.

Changes

No recorded changes to this operation across all 1 revision of this API.