KEkeycardai
Providers

Create provider

Changed on

Creates a new Provider - a system that supplies access to Resources and allows actors to authenticate

post/zones/{zoneId}/providers

Request

  • Base URL
    https://docs.keycard.ai (the document declares no server; this is the origin it was published from)
  • URL
    https://docs.keycard.ai/zones/{zoneId}/providers
  • Auth
    • HTTP bearer
    • or OAuth 2
      Client credentials
      Token URL: /service-account-token

Path parameters

zoneIdstring required

Request body

namestring safe-text required

Human-readable name. Must not contain HTML tags (e.g. <script>, <div>) or control characters.

descriptionstring safe-text nullable

Human-readable description. Must not contain HTML tags (e.g. <script>, <div>) or control characters.

identifierstring safe-text required

User specified identifier, unique within the zone. Must not contain HTML tags (e.g. <script>, <div>) or control characters.

client_idstring

OAuth 2.0 client identifier

client_secretstring

OAuth 2.0 client secret (will be encrypted and stored securely)

Response

A Provider is a system that supplies access to Resources and allows actors (Users or Applications) to authenticate.

idstring required

Unique identifier of the provider

organization_idstring required

Organization that owns this provider

zone_idstring required

Zone this provider belongs to

slugstring required

URL-safe identifier, unique within the zone

namestring required

Human-readable name

descriptionstring nullable

Human-readable description

identifierstring required

User specified identifier, unique within the zone

type'external' | 'keycard-vault' | 'keycard-sts'
client_idstring nullable

OAuth 2.0 client identifier

client_secret_setboolean

Indicates whether a client secret is configured

owner_type'platform' | 'customer' required

Who owns this provider. Platform-owned providers cannot be modified via API.

created_atstring date-time required

Entity creation timestamp

updated_atstring date-time required

Entity update timestamp

Changes

  • 0cfaff865771Revision changes
    • warning

      removed the request property //

    • warning

      removed the optional property // from the response with the status

  • d65d51379d93Revision changes
    • info

      added the new optional request property /

    • info

      added the new optional request property //

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property // to the response with the status