v52

OpenAPI 3.0.3raw.githubusercontent.com2026-08-04170260320.4 KB

IssueMagicAuthToken creates a "magic" auth token that provides limited access to a specific filtered dashboard in a specific project.

post/v1/orgs/{org}/projects/{project}/tokens/magic

Path parameters

orgstring required

Org that owns the project.

projectstring required

Project to create the magic auth token in.

Request body

displayNamestring

Optional display name to store with the token.

fieldsstring[]

Optional list of fields to limit access to. If empty, no field access rule will be added. This will be translated to a rill.runtime.v1.SecurityRuleFieldAccess, which currently applies to dimension and measure names for explores and metrics views.

metricsViewFiltersobject

Optional metrics view to filter mapping to apply as row filters in queries. This will be translated to a rill.runtime.v1.SecurityRuleRowFilter with the metrics view in the condition_resources, which currently applies to metric views queries.

resourceNamestring

Name of the resource to grant access to.

resourceTypestring

Type of resource to grant access to.

statestring

Optional state to store with the token. Can be fetched with GetCurrentMagicAuthToken.

ttlMinutesstring int64

TTL for the token in minutes. Set to 0 for no expiry. Defaults to no expiry.

Response

A successful response.

tokenstring
urlstring