Brand

Learn the brand from a website

Reads about ten key pages of the site, the company's past posts and what others say about it, saves logos and product shots to the library, and replaces the brand profile. Runs one to three minutes in the background: the answer is the finished profile, or status running with a run_id to follow with GET /brand/learn/{run_id}.

POSThttps://traceeai.com/api/v1/brand/learn

CLI:tracee brand learn·MCP:brandaction learn

Authorizations

Authorizationstringheaderrequired
Bearer <key>: a personal key (tracee login or Settings → Personal keys), a workspace key, or an MCP client's OAuth token. See Authentication.

Headers

Tracee-Workspacestring
For a personal key or OAuth token that reaches several workspaces: the workspace id to act on. Workspace keys don't need it.
uuid

Query parameters

waitinteger
Seconds to wait for the job before answering (0-290; default 50). If it isn't done by then the answer is 202 with its id to follow.
0–290

Body

application/json

urlstringrequired
The company's website
up to 1,000 characters

Response

Errors

200Already done.
The action's result, exactly as the MCP tool returns it to agents. A next field, when present, names the endpoint that follows up.
202Started or still running: follow it with the id in the answer.
The action's result, exactly as the MCP tool returns it to agents. A next field, when present, names the endpoint that follows up.