The v1-api-keys API from Ardent — 2 operation(s) for v1-api-keys.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
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.curl "https://apis.io/api/v1/apis/ardent-v1-api-keys-api"curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
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: 3.2.0
info:
description: Public Ardent API. Generated by scripts/export_public_openapi.py — do not edit by hand.
title: Ardent V1 API Keys API
version: v1
servers:
- url: https://api.tryardent.com
tags:
- name: v1-api-keys
paths:
/v1/orgs/{org_id}/api-keys:
get:
operationId: list_api_keys_v1_orgs__org_id__api_keys_get
parameters:
- in: path
name: org_id
required: true
schema:
title: Org Id
type: string
responses:
'200':
content:
application/json:
schema:
items:
$ref: '#/components/schemas/APIKeyListItem'
additionalProperties: true
type: object
title: Response 200 List Api Keys V1 Orgs Org Id Api Keys Get
type: array
description: Active (unrevoked) keys, newest first.
'422':
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
description: Validation Error
security:
- bearerAuth: []
summary: List Api Keys
tags:
- v1-api-keys
post:
operationId: create_new_api_key_v1_orgs__org_id__api_keys_post
parameters:
- in: path
name: org_id
required: true
schema:
title: Org Id
type: string
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/CreateAPIKeyRequest'
required: true
responses:
'201':
content:
application/json:
schema:
$ref: '#/components/schemas/APIKeyCreateResponse'
additionalProperties: true
title: Response Create New Api Key V1 Orgs Org Id Api Keys Post
type: object
description: The created key, including the secret — shown only this once.
'400':
description: Unknown role, non-org role, or a scope outside the role's permissions.
'422':
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
description: Validation Error
security:
- bearerAuth: []
summary: Create New Api Key
tags:
- v1-api-keys
/v1/orgs/{org_id}/api-keys/{api_key_id}:
delete:
operationId: revoke_api_key_endpoint_v1_orgs__org_id__api_keys__api_key_id__delete
parameters:
- in: path
name: org_id
required: true
schema:
title: Org Id
type: string
- in: path
name: api_key_id
required: true
schema:
title: Api Key Id
type: string
responses:
'204':
description: Successful Response
'404':
description: API key not found or already revoked.
'422':
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
description: Validation Error
security:
- bearerAuth: []
summary: Revoke Api Key Endpoint
tags:
- v1-api-keys
components:
schemas:
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
title: Detail
type: array
title: HTTPValidationError
type: object
CreateAPIKeyRequest:
properties:
expires_days:
anyOf:
- type: integer
- type: 'null'
description: Days until expiration (null = never expires)
title: Expires Days
name:
description: Descriptive name for the key
maxLength: 100
minLength: 1
title: Name
type: string
role_id:
description: Role ID to grant to this API key (e.g., role_org_member)
title: Role Id
type: string
scopes:
default: []
description: Permission keys like `connectors.read`, a subset of the role's; empty uses all.
items:
type: string
title: Scopes
type: array
required:
- name
- role_id
title: CreateAPIKeyRequest
type: object
APIKeyListItem:
additionalProperties: true
properties:
created_at:
description: When the key was created.
title: Created At
type: string
expires_at:
anyOf:
- type: string
- type: 'null'
description: When the key expires. Null when it does not expire.
title: Expires At
id:
description: API key ID.
title: Id
type: string
key_prefix:
description: First characters of the key; the secret itself is never returned.
title: Key Prefix
type: string
last_used_at:
anyOf:
- type: string
- type: 'null'
description: When the key last authenticated a request. Null when never used.
title: Last Used At
name:
description: Human-readable key name.
title: Name
type: string
revoked_at:
anyOf:
- type: string
- type: 'null'
description: When the key was revoked. Null for active keys.
title: Revoked At
scopes:
description: Permission scopes granted to the key.
items:
type: string
title: Scopes
type: array
users:
anyOf:
- additionalProperties: true
type: object
- type: 'null'
description: 'Who created the key: `{email, full_name}`.'
title: Users
required:
- id
- name
- key_prefix
- scopes
- created_at
title: APIKeyListItem
type: object
APIKeyCreateResponse:
additionalProperties: true
properties:
api_key:
description: The full secret key; shown only this once — store it now.
title: Api Key
type: string
api_key_id:
description: ID of the created key.
title: Api Key Id
type: string
created_at:
description: When the key was created.
title: Created At
type: string
expires_at:
anyOf:
- type: string
- type: 'null'
description: When the key expires. Null when it does not expire.
title: Expires At
key_prefix:
description: First characters of the key, for identifying it in lists.
title: Key Prefix
type: string
name:
description: Human-readable key name.
title: Name
type: string
role_id:
description: ID of the role granted to the key.
title: Role Id
type: string
role_key:
description: The role's stable key, for example `role_org_member`.
title: Role Key
type: string
scopes:
description: Permission scopes granted to the key.
items:
type: string
title: Scopes
type: array
warning:
description: Reminder that the secret cannot be retrieved again.
title: Warning
type: string
required:
- api_key_id
- api_key
- name
- key_prefix
- scopes
- created_at
- warning
- role_id
- role_key
title: APIKeyCreateResponse
type: object
ValidationError:
properties:
ctx:
title: Context
type: object
input:
title: Input
loc:
items:
anyOf:
- type: string
- type: integer
title: Location
type: array
msg:
title: Message
type: string
type:
title: Error Type
type: string
required:
- loc
- msg
- type
title: ValidationError
type: object
securitySchemes:
bearerAuth:
description: Ardent API key (sk-ard_live_… / sk-ard_test_…) or a dashboard session token.
scheme: bearer
type: http