FruxonDocs
ApiAgent reviews

Dismisses a recommendation card.

The reason is shown to the reviewer in every later review of this agent, so it learns what the agent's admins don't want. A card dismissed as `WRONG` is never raised again; one dismissed for another reason comes back only if several more conversations show the problem. Send the card's `version` as you saw it: a card that changed since answers 409. Agent admins only.

POST
/v1/tenants/{tenant}/agents/{agent}/recommendations/{recommendation}:dismiss

Authorization

Bearer
AuthorizationBearer <token>

JWT Authorization header using the Bearer scheme. Enter 'Bearer' [space] and then your token.

In: header

Path Parameters

agent*string

The agent ID.

recommendation*string

The recommendation ID.

Formatuuid
tenant*string

The tenant identifier

Request Body

Why, and the card's version.

reason?string

Why an admin dismissed a recommendation — told to the reviewer, so it learns what this agent's admins don't want.

Value in"UNSPECIFIED" | "NOT_RELEVANT" | "WRONG" | "ALREADY_HANDLED" | "OTHER"
note?string|null

Optional: what the admin wants to say about it.

version?integer

The card's version as the admin saw it.

Formatint32
[key: string]?never

Response Body

curl -X POST "https://api.fruxon.com/v1/tenants/string/agents/string/recommendations/497f6eca-6276-4993-bfeb-53cbbbba6f08:dismiss" \  -H "Content-Type: application/json" \  -d '{}'
{
  "id": "00000000-0000-0000-0000-000000000000",
  "kind": "ADD_TOOLS",
  "category": "MISSING_CAPABILITY",
  "severity": "LOW",
  "status": "CANDIDATE",
  "title": "string",
  "summary": "string",
  "need": "string",
  "patch": {
    "tools": [
      {
        "integrationId": "string",
        "id": "string",
        "displayName": "string",
        "actionType": "UNSPECIFIED",
        "availability": "UNSPECIFIED"
      }
    ],
    "instructionText": "string",
    "replaceAnchor": "string",
    "adviceMarkdown": "string",
    "feature": "string"
  },
  "evidenceCount": 0,
  "firstSeenAt": 0,
  "lastSeenAt": 0,
  "baseRevision": 0,
  "appliedRevision": 0,
  "previousRevision": 0,
  "appliedBy": "string",
  "appliedAt": 0,
  "dismissedBy": "string",
  "dismissedAt": 0,
  "dismissReason": "NOT_RELEVANT",
  "dismissNote": "string",
  "obsoleteReason": "string",
  "version": 0
}
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "property1": null,
  "property2": null
}
Empty
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "property1": null,
  "property2": null
}
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "property1": null,
  "property2": null
}
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "property1": null,
  "property2": null
}