Users API

Manage users and permissions.

WARNING

User management endpoints require admin privileges.

List Users

GET /api/v1/users

Response

{
  "data": [
    {
      "id": "usr_abc123",
      "username": "john",
      "email": "john@example.com",
      "role": "developer",
      "created_at": "2025-01-15T10:00:00Z",
      "last_login": "2025-01-15T12:00:00Z"
    }
  ]
}

Get User

GET /api/v1/users/:id

Create User

POST /api/v1/users

Request Body

{
  "username": "jane",
  "email": "jane@example.com",
  "password": "secure-password",
  "role": "developer"
}

Roles

Role	Description
admin	Full access to all features
developer	Deploy, view services, manage alerts
viewer	Read-only access

Update User

PATCH /api/v1/users/:id

Delete User

DELETE /api/v1/users/:id

Get Current User

GET /api/v1/users/me

Update Password

POST /api/v1/users/me/password

{
  "current_password": "old-password",
  "new_password": "new-secure-password"
}

API Keys

List API Keys

GET /api/v1/users/me/api-keys

Create API Key

POST /api/v1/users/me/api-keys

{
  "name": "CI/CD Key",
  "scopes": ["read", "deploy"],
  "expires_at": "2025-12-31T23:59:59Z"
}

Revoke API Key

DELETE /api/v1/users/me/api-keys/:id