vivenu API Keys API
The api_keys API from vivenu — 4 operation(s) for api_keys.
The api_keys API from vivenu — 4 operation(s) for 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/vivenu-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:
title: vivenu API Keys API
description: vivenu API Documentation
version: 1.0.0
contact:
name: vivenu GmbH
url: https://vivenu.com
servers:
- url: https://vivenu.com
description: Production API
- url: https://vivenu.dev
description: Staging API
tags:
- name: API Keys
paths:
/api/keys:
get:
security:
- jwt: []
parameters: []
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/GET_Api_keys_GetAllApiKeys_200_response'
'401':
description: Unauthorized
tags:
- API Keys
description: Get All API Keys
operationId: api-keys/list
summary: Api keys/list
x-summary-source: derived
post:
security:
- jwt: []
parameters: []
responses:
'201':
description: Created
content:
application/json:
schema:
$ref: '#/components/schemas/APIKeyResource'
'400':
description: Bad Request
'401':
description: Unauthorized
'403':
description: Forbidden
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/POST_Api_keys_CreateAnApiKey'
tags:
- API Keys
description: Create an API Key
operationId: api-keys/create
summary: Api keys/create
x-summary-source: derived
/api/keys/info:
get:
security:
- apikey: []
parameters: []
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/APIKeyResource'
'401':
description: Unauthorized
tags:
- API Keys
description: Get Information about the used API Key
operationId: api-keys/getInfo
summary: Api keys/get info
x-summary-source: derived
/api/keys/{id}:
get:
security:
- jwt: []
parameters:
- name: id
required: true
schema:
type: string
description: The ID of the API key.
metas: {}
in: path
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/RedactedAPIKeyResource'
'400':
description: Bad Request
'401':
description: Unauthorized
tags:
- API Keys
description: Get an API Key
operationId: api-keys/get
summary: Api keys/get
x-summary-source: derived
put:
security:
- jwt: []
parameters:
- name: id
required: true
schema:
type: string
description: The ID of the API key.
metas: {}
in: path
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/RedactedAPIKeyResource'
'400':
description: Bad Request
'401':
description: Unauthorized
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/PUT_Api_keys_UpdateAnApiKey'
tags:
- API Keys
description: Update an API Key
operationId: api-keys/update
summary: Api keys/update
x-summary-source: derived
/api/keys/default:
post:
security:
- jwt: []
- orgApiKey: []
parameters: []
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/APIKeyResource'
'400':
description: Bad Request
'401':
description: Unauthorized
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/POST_Api_keys_GetOrCreateADefaultApiKey'
tags:
- API Keys
description: Get or Create a Default API Key
operationId: get_or_create_a_default_api_key
summary: Get or create a default api key
x-summary-source: derived
components:
schemas:
POST_Api_keys_GetOrCreateADefaultApiKey:
type: object
properties:
sellerId:
type: string
description: The seller ID to get or create the API key for.
required:
- sellerId
POST_Api_keys_CreateAnApiKey:
type: object
properties:
name:
type: string
description: An internal name to identify the API key.
orgId:
type: string
description: The organization ID for which to create the API key.
expiresAt:
type: string
format: date-time
description: Optional expiry time (strictly future, at most one year); omit for keys that do not auto-expire.
required:
- name
RedactedAPIKeyResource:
type: object
properties:
_id:
type: string
description: The ID of the API key.
active:
type: boolean
description: Whether the API key can be used to authenticate against the API.
default: true
name:
type: string
maxLength: 200
description: An internal name to identify the API key.
sellerId:
type: string
description: The ID of the seller that owns the API key.
orgId:
type: string
description: The ID of the organisation that owns the API key.
createdBy:
type: object
properties:
type:
type: string
enum:
- USER
- APP
- API_KEY
- SYSTEM
description: The type of the entity
id:
type: string
description: The ID of the entity
required:
- type
- id
description: The entity that created the API key.
createdAt:
type: string
format: date-time
description: An ISO Timestamp indicating when the API Key was created.
updatedAt:
type: string
format: date-time
description: An ISO Timestamp indicating when the API Key was last updated.
expiresAt:
type:
- string
- 'null'
format: date-time
description: Optional ISO instant after which the key no longer authenticates; omit or null for no automatic expiry.
required:
- _id
- name
- createdAt
- updatedAt
APIKeyResource:
type: object
properties:
_id:
type: string
description: The ID of the API key.
active:
type: boolean
description: Whether the API key can be used to authenticate against the API.
default: true
name:
type: string
maxLength: 200
description: An internal name to identify the API key.
sellerId:
type: string
description: The ID of the seller that owns the API key.
orgId:
type: string
description: The ID of the organisation that owns the API key.
key:
type: string
description: The secret key to be used to authenticate against the API.
example: key_somerandomcombinationofnumbersandletters
createdBy:
type: object
properties:
type:
type: string
enum:
- USER
- APP
- API_KEY
- SYSTEM
description: The type of the entity
id:
type: string
description: The ID of the entity
required:
- type
- id
description: The entity that created the API key.
createdAt:
type: string
format: date-time
description: An ISO Timestamp indicating when the API Key was created.
updatedAt:
type: string
format: date-time
description: An ISO Timestamp indicating when the API Key was last updated.
expiresAt:
type:
- string
- 'null'
format: date-time
description: Optional ISO instant after which the key no longer authenticates; omit or null for no automatic expiry.
required:
- _id
- name
- key
- createdAt
- updatedAt
GET_Api_keys_GetAllApiKeys_200_response:
type: array
items:
$ref: '#/components/schemas/RedactedAPIKeyResource'
PUT_Api_keys_UpdateAnApiKey:
type: object
properties:
active:
type: boolean
description: Whether the API key can be used to authenticate against the API.
default: true
name:
type: string
description: An internal name to identify the API key.
expiresAt:
oneOf:
- oneOf:
- type: array
- type: boolean
- type: number
- type: object
- type: string
- type: string
format: date-time
description: Optional expiry; send null to clear automatic expiry.
securitySchemes:
jwt:
type: http
scheme: bearer
bearerFormat: JWT
apikey:
type: apiKey
scheme: bearer
in: header
name: Authorization
customer-jwt:
type: http
scheme: bearer
bearerFormat: JWT
orgApiKey:
type: apiKey
scheme: bearer
in: header
name: Authorization