Skip to content

by Startups.Studio

Agent.mint

POST /{namespace}/agents/mint

Mint creates an Agent in a Customer’s Tenant from an Agent Product the Customer bought.

Noun: Agent
Mode: do
Event: Agent.minted

You, to your agent

Mint the latest agent with a tenant and a product.

curl -X POST https://api.sb/patentpad.com/agents/mint \
  -H "Authorization: Bearer $STARTUP_BUILDER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tenant":"tenant_1","product":"product_1"}'

import { $ } from 'startup-builder'

const agent = await $.Agent.mint({ tenant: 'tenant_1', product: 'product_1' })

npx startup-builder do Agent.mint --json '{"tenant":"tenant_1","product":"product_1"}'

{
  "name": "do",
  "arguments": {
    "code": "return await $.Agent.mint({ tenant: 'tenant_1', product: 'product_1' })"
  }
}

Inputs

Input	Type	Required	Description
`tenant`	Tenant	required	The Customer’s Tenant.
`product`	Product	required	The Agent Product.

Outputs

Output	Type	Required	Description
`agent`	Agent	required	The Customer’s own Agent.

Effects

Emits Agent.minted.
Performed by the People Lead.
Bounds the Agent by the Customer’s Entitlements and their Limits.

Refuses when

Check	Error	Fix	Then call
The operation is part of an Offer the caller has not accepted or paid for.	`payment-required`	Accept the Offer named in the response, then retry the call.	Offer.accept
The key is valid, but its scopes do not allow this operation.	`forbidden`	Use a key whose scopes cover the operation, or ask an owner of the namespace to grant them.	Agent.mint

When it waits

Gate	Default
Decision class	Low: two-way, nothing at stake
Delay window	None: it runs once review passes.
Limit	The call Limit of the Permission it runs under.
Over the Limit	It waits `pending` for an Approval from the Founder. Approved, it runs; refused, it ends `refused` with `limit-exceeded`; unanswered by its deadline, it ends `canceled`.

Agent.list

Previous Page

Agent.pause

Next Page