List Custom API Role Policies

GET 
https://useast.api.elasticpath.com/v2/permissions/custom-api-role-policies

Retrieves a list of Custom API Role Policies

Filtering

The following operators and attributes are available for filtering Custom API Role Policies:

Attribute	Operators	Example
id	lt,le,eq,gt,ge,in	eq(id,3fa85f64-5717-4562-b3fc-2c963f66afa6)
created_at	lt,le,eq,gt,ge	ge(created_at,2024-04-29T00:00:00.000Z)
updated_at	lt,le,eq,gt,ge	le(updated_at,2024-04-29T00:00:00.000Z)
custom_api_id	eq	eq(id,fded1d2a-8bb8-48b6-86a5-9eb05cc8626a)
role_id	eq	eq(id,f5f77dd6-71df-48a4-b4f4-d2605a79f3ca)

Sorting

The following attributes are available for sorting. When specified, the results are sorted in ascending order based on the value of the field. To sort in descending order, prefix the attribute with -, for example, -updated_at. The default sort order is created_at in descending order.

• id
• created_at
• updated_at

Request

Query Parameters

page[offset] int64

Possible values: <= 10000

The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the page length store setting is used.

page[limit] int64

The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the page length store setting is used.

filter string

Filter attributes. For more information, see the Filtering section.

sort string

Sort attributes, For more information, see the Sorting section.

Responses

200

OK

application/json

Schema

Schema

data CustomAPIRolePolicyAttributes[]
Array [
iduuid
The unique identifier for the Custom API Role Policy.
typestring
Specifies the type of the resource object, use custom_api_role_policy for Custom API Role Policies.
createboolean
Specifies if the Built-in Role can create a Custom API Entry.
listboolean
Specifies if the Built-in Role can retrieve a list of Custom API Entries.
readboolean
Specifies if the Built-in Role can get a Custom API Entry.
updateboolean
Specifies if the Built-in Role can update a Custom API Entry.
deleteboolean
Specifies if the Built-in Role can delete a Custom API Entry.
links object
selfuri
Specifies the URI of the Built-In Role.
Example: /v2/permissions/custom-api-role-policies/3fa85f64-5717-4562-b3fc-2c963f66afa6
meta object
timestamps objectrequired
updated_atstringrequired
Specifies the date the entity is created.
Example: 2017-01-10T11:41:19.244Z
created_atstringrequired
Specifies the date the entity is last updated.
Example: 2017-01-10T11:41:19.244Z
relationships object
custom_api objectrequired
data objectrequired
idstringrequired
The unique identifier for the related Custom API.
Example: 652e39d8-d613-493e-8c20-fef99ad6327a
typestringrequired
Specifies the type of the resource object.
role objectrequired
data objectrequired
idstringrequired
The unique identifier for the related Built-In Role.
Example: f5f77dd6-71df-48a4-b4f4-d2605a79f3ca
typestringrequired
Specifies the type of the resource object.
]
meta object
results objectrequired
totalinteger
Total number of results for the entire collection.
page objectrequired
limitinteger
The maximum number of records for all pages.
Example: 100
offsetinteger
The current offset by number of pages.
Example: 0
currentinteger
The current number of pages.
Example: 1
totalinteger
The total number of records for the entire collection.
Example: 1
links object
currenturirequired
Always the current page.
Example: /v2/settings/custom-apis?page[offset]=0&page[limit]=100
firsturirequired
Always the first page.
Example: /v2/settings/custom-apis?page[offset]=0&page[limit]=100
lasturirequired
Always null if there is only one page.
Example: /v2/settings/custom-apis?page[offset]=0&page[limit]=100
nextstring | nullrequired
Always null if there is only one page.
Example: null
prevstring | nullrequired
Always null if the user is on the first page.
Example: null

Example (auto)

{
  "data": [
    {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "type": "string",
      "create": true,
      "list": true,
      "read": true,
      "update": true,
      "delete": true,
      "links": {
        "self": "/v2/permissions/custom-api-role-policies/3fa85f64-5717-4562-b3fc-2c963f66afa6"
      },
      "meta": {
        "timestamps": {
          "updated_at": "2017-01-10T11:41:19.244Z",
          "created_at": "2017-01-10T11:41:19.244Z"
        }
      },
      "relationships": {
        "custom_api": {
          "data": {
            "id": "652e39d8-d613-493e-8c20-fef99ad6327a",
            "type": "string"
          }
        },
        "role": {
          "data": {
            "id": "f5f77dd6-71df-48a4-b4f4-d2605a79f3ca",
            "type": "string"
          }
        }
      }
    }
  ],
  "meta": {
    "results": {
      "total": 0
    },
    "page": {
      "limit": 100,
      "offset": 0,
      "current": 1,
      "total": 1
    }
  },
  "links": {
    "current": "/v2/settings/custom-apis?page[offset]=0&page[limit]=100",
    "first": "/v2/settings/custom-apis?page[offset]=0&page[limit]=100",
    "last": "/v2/settings/custom-apis?page[offset]=0&page[limit]=100",
    "next": null,
    "prev": null
  }
}

400

Bad request. The request failed validation.

application/json

Schema

Schema

errors Error[]required
Array [
titlestringrequired
A brief summary of the error.
statusstringrequired
The HTTP response code of the error.
detailstring
Optional additional detail about the error.
]

Example (auto)

{
  "errors": [
    {
      "title": "string",
      "status": "string",
      "detail": "string"
    }
  ]
}

missing-name

Required field missing

{
  "errors": [
    {
      "detail": "Invalid filter: unknown field [version] specified in search filter, allowed fields are [api_type created_at description id name slug updated_at]",
      "status": "400",
      "title": "Bad Request"
    }
  ]
}

500

Internal server error. There was a system failure in the platform.

application/json

Schema

Schema

errors Error[]required
Array [
titlestringrequired
A brief summary of the error.
statusstringrequired
The HTTP response code of the error.
detailstring
Optional additional detail about the error.
]

Example (auto)

{
  "errors": [
    {
      "title": "string",
      "status": "string",
      "detail": "string"
    }
  ]
}

internal-server-error

Internal server error

{
  "errors": [
    {
      "title": "Internal Server Error",
      "status": "500",
      "detail": "there was a problem processing your request"
    }
  ]
}

Authorization: http

name: bearerAuthtype: httpscheme: bearer

• csharp
• curl
• dart
• go
• http
• java
• javascript
• kotlin
• c
• nodejs
• objective-c
• ocaml
• php
• powershell
• python
• r
• ruby
• rust
• shell
• swift

• HTTPCLIENT
• RESTSHARP

var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Get, "https://useast.api.elasticpath.com/v2/permissions/custom-api-role-policies");
request.Headers.Add("Accept", "application/json");
request.Headers.Add("Authorization", "Bearer <token>");
var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
Console.WriteLine(await response.Content.ReadAsStringAsync());

Request Collapse all

Base URL

https://useast.api.elasticpath.com

Auth

Bearer Token

Parameters

page[offset] — query

page[limit] — query

filter — query

sort — query

ResponseClear

Click the Send API Request button above and see the response here!