research-reports

Create agent report

Changed on

Save external analysis. Producer kinds site_audit, ai_visibility and prompt_explorer are reserved. Access follows existing project membership and token scopes.

post/projects/{project_id}/agent-reports

Request

  • Base URL: https://eu.bisibility.com/api/v1
  • URL: https://eu.bisibility.com/api/v1/projects/{project_id}/agent-reports
  • Auth: one of:
    • HTTP bearer
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL /api/auth/oauth2/authorize, token URL /api/auth/oauth2/token, scopes: api:write)

Path parameters

project_idstring required

The public project ID. Project membership and token scopes are enforced.

Headers

Bisibility-API-Version'v1'

API contract version requested by the client. Omit this header to use the current backward-compatible behavior.

X-Bisibility-Source'sdk' | 'cli' | 'mcp'

Declares the client that produced the request for usage reporting: sdk, cli or mcp. Optional; any other value counts as api. It never changes authentication or which budget applies (every bearer-authenticated request counts against the API, MCP and SDK budget).

Request body

kindstring required

External analysis kind; site_audit, ai_visibility and prompt_explorer are reserved.

titlestring required

Human-readable report title.

bodyobject required

Structured analysis. Maximum 256 KiB; untrusted text is rendered safely.

provenanceobject

Source attribution and limitations. Maximum 32 KiB.

Response

Project-scoped result

Changes