seahaven-ap/packages/api/openapi/components/schemas.yaml

55 lines
1.1 KiB
YAML
Raw Normal View History

Error:
type: object
required:
- error
properties:
error:
type: string
description: Human-readable error message.
example: Missing or invalid Authorization header.
HealthResponse:
type: object
required:
- status
- database
properties:
status:
type: string
description: Process health marker.
example: ok
database:
type: string
description: Database ping result.
example: up
MeResponse:
type: object
required:
- id
- email
- name
- role
properties:
id:
type: string
format: uuid
description: Internal user primary key.
example: 11111111-1111-4111-8111-111111111111
email:
type: string
format: email
description: Caller email address.
example: admin@seahavenind.com
name:
type: string
description: Display name for the caller.
example: Dev Admin
role:
type: string
description: Authorization role for RBAC checks.
enum:
- admin
- ap_processor
- approver
- viewer
example: admin