Appfire Permissions Resource API

The permissions-resource API from Appfire — 9 operation(s) for permissions-resource.

Operations 9

POST /api/v2/settings/permissions/basic/swap Swap basic setting #
POST /api/v2/settings/permissions/basic/editUsers Edit basic users #
POST /api/v2/settings/permissions/advanced/roles/edit Update existing role #
POST /api/v2/settings/permissions/advanced/roles/delete Delete existing role #
POST /api/v2/settings/permissions/advanced/roles/create Create custom role #
POST /api/v2/settings/permissions/advanced/permission/change Update permission role assignment #
POST /api/v2/settings/permissions/advanced/ownership Set context role configuration #
GET /api/v2/settings/permissions/basic Get basic settings #
GET /api/v2/settings/permissions/advanced Get advanced settings #

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/appfire:appfire-permissions-resource-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.

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

OpenAPI Specification

appfire-permissions-resource-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: OpenAPI definition Permissions Resource API
  version: v0
servers:
- url: http://okr-ppm-prod.appfire.com
  description: Generated server url
tags:
- name: permissions-resource
paths:
  /api/v2/settings/permissions/basic/swap:
    post:
      tags:
      - permissions-resource
      operationId: swapBasicSetting
      parameters:
      - name: settingKey
        in: query
        required: true
        schema:
          type: string
          enum:
          - FULL_ACCESS
          - GLOBAL_SETTINGS_CONTROL
          - EDITING_CONTROL
          - GLOBAL_SETTINGS_AND_EDITING_CONTROL
          - ADVANCED_SETUP
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                type: string
      summary: Swap basic setting
      x-summary-source: derived
  /api/v2/settings/permissions/basic/editUsers:
    post:
      tags:
      - permissions-resource
      operationId: editBasicUsers
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ChangeMembersBean'
        required: true
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                type: string
      summary: Edit basic users
      x-summary-source: derived
  /api/v2/settings/permissions/advanced/roles/edit:
    post:
      tags:
      - permissions-resource
      operationId: updateExistingRole
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/EditRoleAssignmentTableItemBean'
        required: true
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                type: string
      summary: Update existing role
      x-summary-source: derived
  /api/v2/settings/permissions/advanced/roles/delete:
    post:
      tags:
      - permissions-resource
      operationId: deleteExistingRole
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/EditRoleAssignmentTableItemBean'
        required: true
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                type: string
      summary: Delete existing role
      x-summary-source: derived
  /api/v2/settings/permissions/advanced/roles/create:
    post:
      tags:
      - permissions-resource
      operationId: createCustomRole
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/EditRoleAssignmentTableItemBean'
        required: true
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                type: string
      summary: Create custom role
      x-summary-source: derived
  /api/v2/settings/permissions/advanced/permission/change:
    post:
      tags:
      - permissions-resource
      operationId: updatePermissionRoleAssignment
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ChangePermissionAssignmentBean'
        required: true
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                type: string
      summary: Update permission role assignment
      x-summary-source: derived
  /api/v2/settings/permissions/advanced/ownership:
    post:
      tags:
      - permissions-resource
      operationId: setContextRoleConfiguration
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/OwnerShipBasedRolesConfigurationBean'
        required: true
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                type: string
      summary: Set context role configuration
      x-summary-source: derived
  /api/v2/settings/permissions/basic:
    get:
      tags:
      - permissions-resource
      operationId: getBasicSettings
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                type: string
      summary: Get basic settings
      x-summary-source: derived
  /api/v2/settings/permissions/advanced:
    get:
      tags:
      - permissions-resource
      operationId: getAdvancedSettings
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                type: string
      summary: Get advanced settings
      x-summary-source: derived
components:
  schemas:
    OwnerShipBasedRolesConfigurationBean:
      type: object
      properties:
        enabled:
          type: boolean
        managerOn:
          type: boolean
        ownerOn:
          type: boolean
        collaboratorOn:
          type: boolean
        teamMemberOn:
          type: boolean
      required:
      - collaboratorOn
      - enabled
      - managerOn
      - ownerOn
      - teamMemberOn
    ChangeMembersBean:
      type: object
      properties:
        type:
          type: string
          enum:
          - GLOBAL_SETTINGS
          - EDITING_CONTROL
        members:
          type: array
          items:
            $ref: '#/components/schemas/UserOrTeam'
      required:
      - members
      - type
    EditRoleAssignmentTableItemBean:
      type: object
      properties:
        roleId:
          type: string
        roleName:
          type: string
        defaultRole:
          type: boolean
        userOrTeams:
          type: array
          items:
            $ref: '#/components/schemas/UserOrTeam'
      required:
      - defaultRole
      - roleId
      - roleName
      - userOrTeams
    UserOrTeam:
      type: object
      properties:
        id:
          type: string
        type:
          type: string
          enum:
          - USER
          - TEAM
      required:
      - type
    ChangePermissionAssignmentBean:
      type: object
      properties:
        roleId:
          type: string
        permissionKeys:
          type: array
          items:
            type: string
        checked:
          type: boolean
      required:
      - checked
      - permissionKeys
      - roleId
x-provenance:
  method: harvested
  publisher: Appfire
  source: https://okr-ppm-prod.appfire.com/v3/api-docs
  note: split by refine-openapis from the provider's own published document, verified by fetch (openapi/_original/*.fetch.json);
    stamped by stamp-openapi-provenance.py (roadmap#793)