# API Client Management

Manage API clients and credentials

## GET /api-clients

>

```json
{"openapi":"3.0.0","info":{"title":"Formflow API","version":"1.0"},"tags":[{"name":"API Client Management","description":"Manage API clients and credentials"}],"security":[{"access-token":[]}],"components":{"securitySchemes":{},"schemas":{"ListApiClientsResponseDto":{"type":"object","properties":{"clients":{"type":"array","items":{"$ref":"#/components/schemas/ApiClient"}}},"required":["clients"]},"ApiClient":{"type":"object","properties":{}}}},"paths":{"/api-clients":{"get":{"operationId":"ApiClientsController_listApiClients","parameters":[],"responses":{"200":{"description":"API clients retrieved successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListApiClientsResponseDto"}}}}},"tags":["API Client Management"]}}}}
```

## POST /api-clients

>

```json
{"openapi":"3.0.0","info":{"title":"Formflow API","version":"1.0"},"tags":[{"name":"API Client Management","description":"Manage API clients and credentials"}],"security":[{"access-token":[]}],"components":{"securitySchemes":{},"schemas":{"CreateApiClientsRequestDto":{"type":"object","properties":{}},"CreateApiClientsResponseDto":{"type":"object","properties":{"clientSecret":{"type":"string","description":"The raw client secret (only shown once during creation)"},"message":{"type":"string","description":"Important message about storing the secret"}},"required":["clientSecret","message"]}}},"paths":{"/api-clients":{"post":{"operationId":"ApiClientsController_createApiClient","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateApiClientsRequestDto"}}}},"responses":{"201":{"description":"API client created successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateApiClientsResponseDto"}}}}},"tags":["API Client Management"]}}}}
```

## DELETE /api-clients/{clientId}

>

```json
{"openapi":"3.0.0","info":{"title":"Formflow API","version":"1.0"},"tags":[{"name":"API Client Management","description":"Manage API clients and credentials"}],"security":[{"access-token":[]}],"components":{"securitySchemes":{},"schemas":{"RevokeApiClientResponseDto":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}},"paths":{"/api-clients/{clientId}":{"delete":{"operationId":"ApiClientsController_revokeApiClient","parameters":[{"name":"clientId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"API client revoked successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RevokeApiClientResponseDto"}}}}},"tags":["API Client Management"]}}}}
```

## PATCH /api-clients/{clientId}/rotate-secret

>

```json
{"openapi":"3.0.0","info":{"title":"Formflow API","version":"1.0"},"tags":[{"name":"API Client Management","description":"Manage API clients and credentials"}],"security":[{"access-token":[]}],"components":{"securitySchemes":{},"schemas":{"RotateSecretResponseDto":{"type":"object","properties":{"clientId":{"type":"string"},"clientSecret":{"type":"string"},"message":{"type":"string"}},"required":["clientId","clientSecret","message"]}}},"paths":{"/api-clients/{clientId}/rotate-secret":{"patch":{"operationId":"ApiClientsController_rotateSecret","parameters":[{"name":"clientId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"Secret rotated successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RotateSecretResponseDto"}}}}},"tags":["API Client Management"]}}}}
```