action contract_p_get_users_resource {
  label: "Get all users"
  description: "Return the list of users\n\n**Permission required:** edit_users"
  provider: contract_p
  method: GET
  path: "/users"
  encoding: json
  input: {
    type: "object"
    properties: {
      "X-Fields": {
        type: "string"
        format: "mask"
      }
    }
    additionalProperties: false
  }
  output: {
    type: "array"
    items: {
      type: "object"
      required: ["active", "id", "roles", "username"]
      properties: {
        active: {
          type: "boolean"
          description: "Inactive users have to reset their password first"
        }
        confirmed_at: {
          type: "string"
          format: "date-time"
        }
        id: {
          type: "string"
        }
        roles: {
          type: "array"
          description: "the user roles"
          items: {
            type: "object"
            required: ["role"]
            properties: {
              document_id: {
                type: "string"
                description: "limited to a document"
              }
              inbox: {
                type: "string"
              }
              role: {
                type: "string"
              }
            }
          }
        }
        username: {
          type: "string"
          description: "the user username"
        }
      }
    }
  }
}