Organization API Keys

Download schema

Organization API key management

List API keys

GET

https://app.monad.com/api

/v2/{organization_id}/api_keys

Authorization (header)

x-api-key (header)

Required Permissions: apikey:read

List API keys

List API keys › path Parameters

organization_id

string · required

Organization ID

List API keys › query Parameters

limit

integer

Limit

offset

integer

Offset

List API keys › Responses

List of API keys

models.APIKeyList

models.APIKey[]

models.Pagination

Create API key

POST

https://app.monad.com/api

/v2/{organization_id}/api_keys

Authorization (header)

x-api-key (header)

Required Permissions: apikey:write

Create API key

Create API key › path Parameters

organization_id

string · required

Organization ID

Create API key › Request Body

oneOf

Exactly one variant must match.

Decision Table

Variant	Matching Criteria
	type = object
	type = object · requires: expiration_time, name, role_id

Properties for Variant 1:

Create API key › Responses

API key created successfully

models.APIKeyWithToken

created_at

string

description

string

expiration_time

string

id

string

jwt_signing_key_id

string

JWTSigningKeyID is the jwt_signing_keys row that signed the key's current token. Re-stamped on rotation. Empty when signed via the legacy HS256 path (no signing-key row), or for keys created before this was recorded.

name

string

organization_id

string

role_id

string

token

string

token_version

integer

TokenVersion is the current generation of the key. It is embedded in minted JWTs as the ver claim and bumped on rotation to invalidate previously-issued tokens without changing the key's id.

updated_at

string

Get API key

GET

https://app.monad.com/api

/v2/{organization_id}/api_keys/{api_key_id}

Authorization (header)

x-api-key (header)

Required Permissions: apikey:read

Get API key

Get API key › path Parameters

organization_id

string · required

Organization ID

api_key_id

string · required

API Key ID

Get API key › Responses

API key details

models.APIKey

created_at

string

description

string

expiration_time

string

id

string

jwt_signing_key_id

string

name

string

organization_id

string

role_id

string

token_version

integer

TokenVersion is the current generation of the key. It is embedded in minted JWTs as the ver claim and bumped on rotation to invalidate previously-issued tokens without changing the key's id.

updated_at

string

Delete API key

DELETE

https://app.monad.com/api

/v2/{organization_id}/api_keys/{api_key_id}

Authorization (header)

x-api-key (header)

Required Permissions: apikey:delete

Delete API key

Delete API key › path Parameters

organization_id

string · required

Organization ID

api_key_id

string · required

API Key ID

Delete API key › Responses

API key deleted successfully

string

Update API key

PATCH

https://app.monad.com/api

/v2/{organization_id}/api_keys/{api_key_id}

Authorization (header)

x-api-key (header)

Required Permissions: apikey:write

Update API key

Update API key › path Parameters

organization_id

string · required

Organization ID

api_key_id

string · required

API Key ID

Update API key › Request Body

oneOf

Exactly one variant must match.

Decision Table

Variant	Matching Criteria
	type = object
	type = object · requires: name

Properties for Variant 1:

Update API key › Responses

API key updated successfully

models.APIKey

created_at

string

description

string

expiration_time

string

id

string

jwt_signing_key_id

string

name

string

organization_id

string

role_id

string

token_version

integer

TokenVersion is the current generation of the key. It is embedded in minted JWTs as the ver claim and bumped on rotation to invalidate previously-issued tokens without changing the key's id.

updated_at

string

Regenerate API key

POST

https://app.monad.com/api

/v2/{organization_id}/api_keys/{api_key_id}/regenerate

Authorization (header)

x-api-key (header)

Required Permissions: apikey:write

Regenerates an API key by creating a new one with the same metadata and deleting the old one

Regenerate API key › path Parameters

organization_id

string · required

Organization ID

api_key_id

string · required

API Key ID

Regenerate API key › Responses

New API key generated successfully

models.APIKeyWithToken

created_at

string

description

string

expiration_time

string

id

string

jwt_signing_key_id

string

name

string

organization_id

string

role_id

string

token

string

token_version

integer

TokenVersion is the current generation of the key. It is embedded in minted JWTs as the ver claim and bumped on rotation to invalidate previously-issued tokens without changing the key's id.

updated_at

string

Permissions Sessions

Monad API

Organization API Keys

Download schema

Organization API key management

List API keys

GET

https://app.monad.com/api

/v2/{organization_id}/api_keys

Authorization (header)

x-api-key (header)

Required Permissions: apikey:read

List API keys

List API keys › path Parameters

organization_id

string · required

Organization ID

List API keys › query Parameters

limit

integer

Limit

offset

integer

Offset

List API keys › Responses

List of API keys

models.APIKeyList

models.APIKey[]

models.Pagination

Create API key

POST

https://app.monad.com/api

/v2/{organization_id}/api_keys

Authorization (header)

x-api-key (header)

Required Permissions: apikey:write

Create API key

Create API key › path Parameters

organization_id

string · required

Organization ID

Create API key › Request Body

oneOf

Exactly one variant must match.

Decision Table

Variant	Matching Criteria
	type = object
	type = object · requires: expiration_time, name, role_id

Properties for Variant 1:

Create API key › Responses

API key created successfully

models.APIKeyWithToken

created_at

string

description

string

expiration_time

string

id

string

jwt_signing_key_id

string

name

string

organization_id

string

role_id

string

token

string

token_version

integer

TokenVersion is the current generation of the key. It is embedded in minted JWTs as the ver claim and bumped on rotation to invalidate previously-issued tokens without changing the key's id.

updated_at

string

Get API key

GET

https://app.monad.com/api

/v2/{organization_id}/api_keys/{api_key_id}

Authorization (header)

x-api-key (header)

Required Permissions: apikey:read

Get API key

Get API key › path Parameters

organization_id

string · required

Organization ID

api_key_id

string · required

API Key ID

Get API key › Responses

API key details

models.APIKey

created_at

string

description

string

expiration_time

string

id

string

jwt_signing_key_id

string

name

string

organization_id

string

role_id

string

token_version

integer

TokenVersion is the current generation of the key. It is embedded in minted JWTs as the ver claim and bumped on rotation to invalidate previously-issued tokens without changing the key's id.

updated_at

string

Delete API key

DELETE

https://app.monad.com/api

/v2/{organization_id}/api_keys/{api_key_id}

Authorization (header)

x-api-key (header)

Required Permissions: apikey:delete

Delete API key

Delete API key › path Parameters

organization_id

string · required

Organization ID

api_key_id

string · required

API Key ID

Delete API key › Responses

API key deleted successfully

string

Update API key

PATCH

https://app.monad.com/api

/v2/{organization_id}/api_keys/{api_key_id}

Authorization (header)

x-api-key (header)

Required Permissions: apikey:write

Update API key

Update API key › path Parameters

organization_id

string · required

Organization ID

api_key_id

string · required

API Key ID

Update API key › Request Body

oneOf

Exactly one variant must match.

Decision Table

Variant	Matching Criteria
	type = object
	type = object · requires: name

Properties for Variant 1:

Update API key › Responses

API key updated successfully

models.APIKey

created_at

string

description

string

expiration_time

string

id

string

jwt_signing_key_id

string

name

string

organization_id

string

role_id

string

token_version

integer

TokenVersion is the current generation of the key. It is embedded in minted JWTs as the ver claim and bumped on rotation to invalidate previously-issued tokens without changing the key's id.

updated_at

string

Regenerate API key

POST

https://app.monad.com/api

/v2/{organization_id}/api_keys/{api_key_id}/regenerate

Authorization (header)

x-api-key (header)

Required Permissions: apikey:write

Regenerates an API key by creating a new one with the same metadata and deleting the old one

Regenerate API key › path Parameters

organization_id

string · required

Organization ID

api_key_id

string · required

API Key ID

Regenerate API key › Responses

New API key generated successfully

models.APIKeyWithToken

created_at

string

description

string

expiration_time

string

id

string

jwt_signing_key_id

string

name

string

organization_id

string

role_id

string

token

string

token_version

integer

TokenVersion is the current generation of the key. It is embedded in minted JWTs as the ver claim and bumped on rotation to invalidate previously-issued tokens without changing the key's id.

updated_at

string

Permissions Sessions