action contract_p_post_users_resource {
  label: "Create user"
  description: "Create a new user with the provided attributes and roles\n\n**Permission required:** edit_users"
  provider: contract_p
  method: POST
  path: "/users"
  encoding: json
  input: {
    type: "object"
    properties: {
      "X-Fields": {
        type: "string"
        format: "mask"
      }
      active: {
        type: "boolean"
        description: "Inactive users have to reset their password first"
      }
      password: {
        type: "string"
        description: "the user password"
      }
      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"
      }
    }
    required: ["active", "roles", "username"]
    additionalProperties: false
  }
  output: {
    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"
      }
    }
  }
}