Gremlin

Gremlin apikeys API

Create, delete, activate, deactivate and list apikeys

Documentation GitHub OpenAPI

Operations 7

PUT /apikeys/{identifier}/activate Un-Revoke an existing API Key #

GET /apikeys List all API Keys #

POST /apikeys Create a new API Key #

PUT /apikeys/{identifier}/expiration Set a new expiration on key #

GET /apikeys/active List active API Keys #

GET /apikeys/all-for-company List all API Keys for company #

DELETE /apikeys/{identifier} Revoke an existing API Key #

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/gremlin-apikeys-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: Gremlin agents Apikeys API
  description: The API for interacting with the Gremlin Failure-as-a-Service platform
  termsOfService: https://www.gremlin.com/terms_of_service_2017_03_24
  contact:
    name: Gremlin Support
    email: support@gremlin.com
  license:
    name: Gremlin License
    url: https://www.gremlin.com/license_2017_03_24
  version: '1.0'
servers:
- url: https://api.gremlin.com/v1
  description: Gremlin API v1
tags:
- name: apikeys
  description: Create, delete, activate, deactivate and list apikeys
paths:
  /apikeys/{identifier}/activate:
    put:
      tags:
      - apikeys
      summary: Un-Revoke an existing API Key
      description: Requires the privilege [`API_KEYS_WRITE`](https://www.gremlin.com/docs/user-management/access-control/#privileges)
      operationId: activate_2
      parameters:
      - name: identifier
        in: path
        required: true
        schema:
          type: string
      responses:
        default:
          description: default response
          content:
            '*/*': {}
        '403':
          description: 'User requires privilege: API_KEYS_WRITE'
        '401':
          description: Authorization header missing or malformed. Please provide proper credentials in the authorization header.
      security:
      - privilege:
        - API_KEYS_WRITE
  /apikeys:
    get:
      tags:
      - apikeys
      summary: List all API Keys
      description: Requires the privilege [`API_KEYS_READ`](https://www.gremlin.com/docs/user-management/access-control/#privileges)
      operationId: listAll
      parameters: []
      responses:
        default:
          description: default response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ApiKeyJson'
        '403':
          description: 'User requires privilege: API_KEYS_READ'
        '401':
          description: Authorization header missing or malformed. Please provide proper credentials in the authorization header.
      security:
      - privilege:
        - API_KEYS_READ
    post:
      tags:
      - apikeys
      summary: Create a new API Key
      description: Requires the privilege [`API_KEYS_WRITE`](https://www.gremlin.com/docs/user-management/access-control/#privileges)
      operationId: createNew
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateApiKeysRequest'
        required: true
      responses:
        default:
          description: default response
          content:
            text/plain: {}
        '403':
          description: 'User requires privilege: API_KEYS_WRITE'
        '401':
          description: Authorization header missing or malformed. Please provide proper credentials in the authorization header.
      security:
      - privilege:
        - API_KEYS_WRITE
  /apikeys/{identifier}/expiration:
    put:
      tags:
      - apikeys
      summary: Set a new expiration on key
      description: Requires the privilege [`API_KEYS_WRITE`](https://www.gremlin.com/docs/user-management/access-control/#privileges)
      operationId: expiration
      parameters:
      - name: identifier
        in: path
        required: true
        schema:
          type: string
      - name: expiresAt
        in: query
        schema:
          type: string
          format: date-time
      responses:
        default:
          description: default response
          content:
            '*/*': {}
        '403':
          description: 'User requires privilege: API_KEYS_WRITE'
        '401':
          description: Authorization header missing or malformed. Please provide proper credentials in the authorization header.
      security:
      - privilege:
        - API_KEYS_WRITE
  /apikeys/active:
    get:
      tags:
      - apikeys
      summary: List active API Keys
      description: Requires the privilege [`API_KEYS_READ`](https://www.gremlin.com/docs/user-management/access-control/#privileges)
      operationId: listActive
      parameters: []
      responses:
        default:
          description: default response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ApiKeyJson'
        '403':
          description: 'User requires privilege: API_KEYS_READ'
        '401':
          description: Authorization header missing or malformed. Please provide proper credentials in the authorization header.
      security:
      - privilege:
        - API_KEYS_READ
  /apikeys/all-for-company:
    get:
      tags:
      - apikeys
      summary: List all API Keys for company
      description: Requires the privilege [`ALL_API_KEYS_READ`](https://www.gremlin.com/docs/user-management/access-control/#privileges)
      operationId: listAllForCompany
      parameters: []
      responses:
        default:
          description: default response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ApiKeyJson'
        '403':
          description: 'User requires privilege: ALL_API_KEYS_READ'
        '401':
          description: Authorization header missing or malformed. Please provide proper credentials in the authorization header.
      security:
      - privilege:
        - ALL_API_KEYS_READ
  /apikeys/{identifier}:
    delete:
      tags:
      - apikeys
      summary: Revoke an existing API Key
      description: Requires the privilege [`API_KEYS_WRITE`](https://www.gremlin.com/docs/user-management/access-control/#privileges)
      operationId: revoke_3
      parameters:
      - name: identifier
        in: path
        required: true
        schema:
          type: string
      responses:
        default:
          description: default response
          content:
            '*/*': {}
        '403':
          description: 'User requires privilege: API_KEYS_WRITE'
        '401':
          description: Authorization header missing or malformed. Please provide proper credentials in the authorization header.
      security:
      - privilege:
        - API_KEYS_WRITE
components:
  schemas:
    CreateApiKeysRequest:
      required:
      - identifier
      type: object
      properties:
        identifier:
          maxLength: 100
          minLength: 0
          pattern: ^[a-zA-Z0-9 -]*$
          type: string
        description:
          maxLength: 256
          minLength: 0
          type: string
        expiresAt:
          type: string
          format: date-time
    ApiKeyJson:
      type: object
      properties:
        identifier:
          type: string
          description: The identifier of this API key.
        description:
          type: string
          description: The description for the API key.
        created_at:
          type: string
          description: The date when this API key was created.
          format: date-time
        created_by:
          type: string
          description: The user who created this API key.
        expires_at:
          type: string
          description: The date when this API key expires.
          format: date-time
        revoked_by:
          type: string
          description: The user who revoked this API key.
        state:
          type: string
          description: The current state this API key is in.
          enum:
          - ACTIVE
          - IDLE
          - REVOKED
          - INVITED
        value:
          type: string
          description: The API keys value. The core piece that is used for authentication
        org_id:
          type: string
          description: The identifier of the team this API key is tied to.
        updated_at:
          type: string
          description: The date this API key was last updated.
          format: date-time
        last_used_at:
          type: string
          description: The date this API key was last used.
          format: date-time

Gremlin apikeys API

Operations 7

Documentation

Specifications

Schemas & Data

Other Resources