ProvlyDocs

Search docs

Guides and API endpoints

DocsAPI referenceIdentity & usageWorkspace

Workspace

GET/api/v1/workspace

The workspace bound to the key, the credential and the resource limits of its plan (tracked brands, boards, saved ads).

Bearer API keyMCP tool get_workspace

Try it

GET/api/v1/workspace
curl "https://provly.co/api/v1/workspace" \
  -H "Authorization: Bearer $PROVLY_API_KEY"
200 · Response
{
  "data": {
    "workspace": {
      "id": "ws_123",
      "name": "Acme",
      "plan": "pro"
    },
    "credential": {
      "id": "b1e4…",
      "name": "Production",
      "prefix": "pvly_live_Ab12Cd",
      "created_at": "2026-09-01T10:00:00.000Z",
      "last_used_at": "2026-09-26T08:29:00.000Z"
    },
    "limits": {
      "rate": {
        "perSecond": 20,
        "perMinute": 120,
        "perHour": 1200,
        "perDay": 24000
      },
      "tracked_brands": 10,
      "boards": 50,
      "saved_ads": 2000
    }
  }
}