Permissions

Check Permissions

Lists permission actions and whether the calling credential is granted each one for a resource. Answers for whichever identity authenticated the request — a user session, an OAuth token, or an account or app API key — so it never describes who else can reach the resource.

get/permissions

Query parameters

resource_idstring required

Tag of the resource to check against: an account (biz_), product (prod_), experience (exp_), or app (app_). A resource the credential cannot see is reported as granted nothing rather than as an error.

actionsstring

Comma-separated permission actions to check, for example stats:read,payment:basic:read. Every action is returned when omitted.

Response

permissions listed

Example response

{
  "data": [
    {
      "action": "waitlist_entry:read"
    }
  ]
}

Changes

Changed in 17 of the 74 revisions of this API.363

    • ●

      added the new crypto_wallet:trade enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new crypto_wallet:trade:read enum value to the // response property for the response status

      response-property-enum-value-added

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

    • ●

      added the new waitlist_entry:cancel enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new waitlist_entry:create enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new waitlist_entry:read enum value to the // response property for the response status

      response-property-enum-value-added

    This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

    • ●

      added the new partner:referral_request:accept enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new partner:referral_request:cancel enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new partner:referral_request:create enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new partner:referral_request:decline enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new partner:referral_request:read enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new webhook_receive:financial_activity enum value to the // response property for the response status

      response-property-enum-value-added

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

    • ●

      added the new experiment:manage enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new experiment:read enum value to the // response property for the response status

      response-property-enum-value-added

    This revision's changelog hit the recording limit, so it may not list every change to this endpoint.

    This revision also has 6 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

    • ●

      added the new user:payment:charge enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new webhook_receive:ads enum value to the // response property for the response status

      response-property-enum-value-added

    This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

    • ●

      added the new company:suspend_child enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new partner:email:read enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new partner:invite:create enum value to the // response property for the response status

      response-property-enum-value-added

Of the 74 revisions, 1 has no diff computed.