Skip to main content
GET
Get the Agency workspace

Authorizations

x-preuve-key
string
header
required

Your API key (prv_...), sent as-is. It is the only credential the API needs - see the Authentication guide.

Query Parameters

limit
integer
default:20

Client reports to return in the reports array.

Required range: 1 <= x <= 50
offset
integer
default:0

Paging offset into the reports array.

Required range: 0 <= x <= 10000

Response

Workspace, role, quota, and one page of client reports.

agency
object
quota
object

Shared project quota for the workspace, same pool as the dashboard.

canRunScan
boolean

Eligibility, not live availability. True only when the role may run scans, the workspace is approved, billing setup is done, and quota remains. It does not read the service kill switch, the LLM pause or the rate limiters, so a start can still answer 503 or 429 while this is true. None of those refusals spends a project credit.

reports
object[]

One page of the workspace's client reports, newest first, including ones created in the Agency dashboard. Same shape and paging as /api/agent/agency/reports.

nextOffset
integer | null

Offset of the next page of reports, or null on the last page.