GRANSKA

Read the workspace configuration

GEThttps://api.granska.cloud/v1/config

Reads this tenant's resolved workspace configuration — profiles, actions and limits in one call.

Bearer tokenSpends no quota

One call instead of three

This returns your tenant's resolved configuration under a single config key: the profiles it is licensed for, the actions it may run, and its run limits. It is the same information GET /v1/profiles, GET /v1/actions and GET /v1/quotas return one at a time, which is the point — a client that needs all three at startup makes one request.

"Resolved" means inheritance has already been applied. A tenant inherits from a template and the template from the platform defaults, and none of that is visible here: you get the effective answer, which is the one a job would use.

The remainingRuns figure is a snapshot at the moment of the call. For the quota specifically, GET /v1/quotas is the endpoint to poll — it returns the period key and the reset instant as well.

Request
curl https://api.granska.cloud/v1/config \
  -H "Authorization: Bearer $TOKEN"
Response
{
  "config": {
    "tenantId": "tenant_kommunen",
    "type": "B2B",
    "availableProfiles": [
      {
        "id": "lss_utredning",
        "name": "LSS-utredning"
      }
    ],
    "availableStrategies": [
      {
        "id": "action_overklagande",
        "label": "Överklagandeunderlag"
      }
    ],
    "maxRuns": 500,
    "remainingRuns": 487,
    "periodType": "MONTH"
  }
}

What is not in it

Configuration this endpoint returns is the shape of what you may run, never its content: which profiles exist, not the reviewers' prompts; which actions exist, not their templates. Those are authored inside the application and are not part of the public API in either direction.

No parameter selects a different tenant. The token decides which configuration you read, and there is no way to ask for someone else's.

Errors

ErrorWhen
401
UNAUTHORIZED
The Authorization header is missing, is not a readable bearer token, or names no tenant.
401
TOKEN_EXPIRED
The access token was issued by this gateway and has since expired. Not probed: it needs a token older than its own lifetime.
500
INTERNAL_ERROR
An unexpected server-side failure. Not probable from outside — reaching it means something is wrong.

Send it without writing a client

If your organisation already has an account, an administrator can read the resolved configuration from the API tester at /admin/api-tester — a quick way to confirm what a newly issued key can actually reach.