Sign in
Recipes

Get recipe access permissions

Changed on

Retrieve a recipe's access permissions (must have write permission)

get/recipes/{owner}/{name}/permissions

Request

  • The document declares no server URL.
  • Auth: one of:
    • HTTP bearer
    • API key in header x-pollination-token

Path parameters

ownerstring required
namestring required

Query parameters

pageinteger

Page number starting from 1

per-pageinteger

Number of items per page

subject_typestring[]

The type of access policy subject

permissionstring[]

An access policy permission string

Response

Retrieved

typestring

A base class to use when there is no baseclass available to fall on.

pageinteger required

The current page the pagination request is on

per_pageinteger required

The number of pages per pagination request

page_countinteger required

The total number of pages

total_countinteger required

The total number of resources matching the list request

next_pageinteger

The next page, if this on is not the last

Example response

{
  "resources": [
    {
      "subject": {
        "name": "ladybugbot"
      }
    }
  ]
}

Changes

  • e25504ef9dccRevision changes
    • breaking

      response property detail/items/loc/items/ list-of-types was widened by adding types integer to media type application/json of response 422

  • be42c3cf5190Revision changes
    • breaking

      the response's body type changed from no type to object for status

    • info

      added the optional property to the response with the status