Scaleway

Scaleway Permission sets API

Permission sets are the main components of [IAM rules](https://www.scaleway.com/en/docs/iam/concepts/#rule). They consist of sets of one or multiple [permissions](https://www.scaleway.com/en/docs/iam/concepts/#permission). Permission set names contain descriptions that clearly explain their purpose. For example, a permission set that grants access to all actions you can perform on Instances is called:\ `InstancesFullAccess`. Permissions sets (eg.`InstanceReadAccess`) and their [scope](https://www.scaleway.com/en/docs/iam/concepts/#scope) (eg. "on Project A only") make up IAM rules, which define the access rights that a [principal](https://www.scaleway.com/en/docs/iam/concepts/#principal) (user, group or application) should have.

GitHub OpenAPI
Business capability
Identity & Access Management BC-620.20

Operations 1

GET /iam/v1alpha1/permission-sets List permission sets #

Documentation

📖
Documentation
https://www.scaleway.com/en/developers/api/instances/
📖
Documentation
https://www.scaleway.com/en/developers/api/kubernetes/
📖
Documentation
https://www.scaleway.com/en/developers/api/iam/
📖
Documentation
https://www.scaleway.com/en/developers/api/load-balancer/zoned-api/
📖
Documentation
https://www.scaleway.com/en/developers/api/managed-databases-for-postgresql-and-mysql/
📖
Documentation
https://www.scaleway.com/en/developers/api/vpc/
📖
Documentation
https://www.scaleway.com/en/developers/api/serverless-containers/
📖
Documentation
https://www.scaleway.com/en/developers/api/serverless-functions/
📖
Documentation
https://www.scaleway.com/en/developers/api/secret-manager/
📖
Documentation
https://www.scaleway.com/en/developers/api/transactional-email/

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/scaleway/refs/heads/main/openapi/scaleway-permission-sets-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/scaleway-permission-sets-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

scaleway-permission-sets-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: IAM Permission sets API
  description: Identity and Access Management (IAM) allows you to share access to the management of your Scaleway resources and Organization settings, in a controlled and secure manner.
  version: v1alpha1
servers:
- url: https://api.scaleway.com
tags:
- name: Permission Sets
  description: Permission sets are the main components of IAM rules.
paths:
  /iam/v1alpha1/permission-sets:
    get:
      tags:
      - Permission Sets
      operationId: ListPermissionSets
      summary: List permission sets
      description: List permission sets available for given Organization. You must define the `organization_id` in the query path of your request.
      parameters:
      - in: query
        name: order_by
        description: Criteria for sorting results.
        schema:
          type: string
          enum:
          - name_asc
          - name_desc
          - created_at_asc
          - created_at_desc
          x-enum-descriptions:
            values:
              name_asc: Name ascending
              name_desc: Name descending
              created_at_asc: Creation date ascending
              created_at_desc: Creation date descending
          default: name_asc
      - in: query
        name: page_size
        description: Number of results per page. Value must be between 1 and 100.
        schema:
          type: integer
          format: uint32
      - in: query
        name: page
        description: Page number. Value must be greater than 1.
        schema:
          type: integer
          format: int32
      - in: query
        name: organization_id
        description: Filter by Organization ID.
        required: true
        schema:
          type: string
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/scaleway.iam.v1alpha1.ListPermissionSetsResponse'
      security:
      - scaleway: []
      x-codeSamples:
      - lang: cURL
        source: "curl -X GET \\\n  -H \"X-Auth-Token: $SCW_SECRET_KEY\" \\\n  \"https://api.scaleway.com/iam/v1alpha1/permission-sets?organization_id=string\""
      - lang: HTTPie
        source: "http GET \"https://api.scaleway.com/iam/v1alpha1/permission-sets\" \\\n  X-Auth-Token:$SCW_SECRET_KEY \\\n  organization_id==string"
components:
  schemas:
    scaleway.iam.v1alpha1.PermissionSet:
      type: object
      properties:
        id:
          type: string
          description: Id of the permission set.
        name:
          type: string
          description: Name of the permission set.
        scope_type:
          type: string
          description: Scope of the permission set.
          enum:
          - unknown_scope_type
          - projects
          - organization
          - account_root_user
          x-enum-descriptions:
            values:
              unknown_scope_type: Unknown scope type
              projects: Projects
              organization: Organization
              account_root_user: Account root user
          default: unknown_scope_type
        description:
          type: string
          description: Description of the permission set.
        categories:
          type: array
          description: Categories of the permission set.
          nullable: true
          items:
            type: string
      x-properties-order:
      - id
      - name
      - scope_type
      - description
      - categories
    scaleway.iam.v1alpha1.ListPermissionSetsResponse:
      type: object
      properties:
        permission_sets:
          type: array
          description: List of permission sets.
          items:
            $ref: '#/components/schemas/scaleway.iam.v1alpha1.PermissionSet'
        total_count:
          type: integer
          description: Total count of permission sets.
          format: uint32
      x-properties-order:
      - permission_sets
      - total_count
  securitySchemes:
    scaleway:
      in: header
      name: X-Auth-Token
      type: apiKey