ClimateAI

ClimateAI Role API

user role related operations

Documentation GitHub OpenAPI

Operations 7

POST /role/ Creates a new Role #

GET /role/ #

PUT /role/{role_id} Updates a role #

DELETE /role/{role_id} Deletes a role by id #

GET /role/{role_id} #

POST /role/{role_id}/permission/{permission_id} Adds a new Role/Permission association #

DELETE /role/{role_id}/permission/{permission_id} Removes a Role/Permission association #

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/climateai-role-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

openapi: 3.2.0
info:
  title: ClimateAI Platform Role API
  version: '1.0'
  description: ClimateAI authentication and routing gateway for platform services
servers:
- url: /
security:
- jwt: []
tags:
- name: role
  description: user role related operations
paths:
  /role/:
    post:
      responses:
        '500':
          description: Error creating role.
        '409':
          description: Role already exists.
        '201':
          description: Role successfully created.
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/role_response'
      summary: Creates a new Role
      operationId: create a new role
      tags:
      - role
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/role_payload'
        required: true
    get:
      responses:
        '200':
          description: Successfully retrieved roles.
        '500':
          description: Error retrieving roles.
        '204':
          description: No roles found.
      operationId: Get all roles
      tags:
      - role
  /role/{role_id}:
    parameters:
    - in: path
      description: The role id
      name: role_id
      required: true
      schema:
        type: string
    put:
      responses:
        '404':
          description: Role not found.
        '500':
          description: Error updating role.
        '201':
          description: Role successfully updated.
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/role_response'
      summary: Updates a role
      operationId: update a role
      tags:
      - role
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/role_payload'
        required: true
    delete:
      responses:
        '404':
          description: Role not found.
        '500':
          description: Error deleting role.
        '200':
          description: Role successfully deleted.
      summary: Deletes a role by id
      operationId: delete a role
      tags:
      - role
    get:
      responses:
        '404':
          description: Role not found.
        '500':
          description: Error fetching role.
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/role_response'
      operationId: fetch a role
      tags:
      - role
  /role/{role_id}/permission/{permission_id}:
    parameters:
    - in: path
      description: The permission id
      name: permission_id
      required: true
      schema:
        type: string
    - in: path
      description: The role id
      name: role_id
      required: true
      schema:
        type: string
    post:
      responses:
        '404':
          description: Role or permission not found.
        '500':
          description: Error adding association.
        '409':
          description: Association already exists.
        '201':
          description: Association successfully added.
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/role_response'
      summary: Adds a new Role/Permission association
      operationId: add a permission to a role
      tags:
      - role
    delete:
      responses:
        '404':
          description: Association does not exist.
        '500':
          description: Error removing association.
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/role_response'
      summary: Removes a Role/Permission association
      operationId: remove a permission from a role
      tags:
      - role
components:
  schemas:
    role_response:
      required:
      - created_at
      - description
      - id
      - name
      - updated_at
      properties:
        id:
          type: string
          description: role identifier
        created_at:
          type: string
          description: created timestamp
        updated_at:
          type: string
          description: last updated timestamp
        permissions:
          type: array
          description: role permissions
          items:
            $ref: '#/components/schemas/permission_response'
        name:
          type: string
          description: role name
        description:
          type: string
          description: role description
      type: object
    role_payload:
      required:
      - description
      - name
      properties:
        name:
          type: string
          description: role name
        description:
          type: string
          description: role description
      type: object
      additionalProperties: false
    permission_response:
      required:
      - created_at
      - id
      - name
      - updated_at
      properties:
        id:
          type: string
          description: permission identifier
        created_at:
          type: string
          description: created timestamp
        updated_at:
          type: string
          description: last updated timestamp
        name:
          type: string
          description: permission name
      type: object
  securitySchemes:
    jwt:
      type: apiKey
      in: header
      name: Authorization
    apikey:
      type: apiKey
      in: header
      name: X-Api-Key