openapi: 3.0.0
components:
 schemas:
 PutDocumentRequest:
 properties:
 SomeObject:
 type: object
 properties:
 SomeAttribute:
 type: string
 securitySchemes: {}
info:
 title: ''
 description: ''
 version: 712334c8-7b29-46c5-9e93-cd7acb6b8825
paths:
 /create:
 post:
 operationId: createUser
 summary: Create User
 description: Creates a user and then sends a generated password email
 responses:
 '201':
 description: A user object along with generated API Keys
 content:
 application/json:
 schema:
 $ref: '#/components/schemas/PutDocumentResponse'
 '500':
 description: An error message when creating a new user
 content:
 application/json:
 schema:
 $ref: '#/components/schemas/ErrorResponse'

openapi: 3.0.0
components:
 schemas:
 ErrorResponse:
 title: JSON API Schema
 description: >-
 This is a schema for responses in the JSON API format. For more, see
 http://jsonapi.org
 type: object
 required:
 - errors
 properties:
 errors:
 type: array
 items:
 type: object
 properties:
 id:
 description: >-
 A unique identifier for this particular occurrence of the
 problem.
 type: string
 links:
 description: >-
 A resource object **MAY** contain references to other resource
 objects ("relationships"). Relationships may be to-one or
 to-many. Relationships can be specified by including a member
 in a resource's links object.
 type: object
 properties:
 self:
 description: >-
 A `self` member, whose value is a URL for the relationship
 itself (a "relationship URL"). This URL allows the client
 to directly manipulate the relationship. For example, it
 would allow a client to remove an `author` from an
 `article` without deleting the people resource itself.
 type: string
 format: uri
 related:
 description: >-
 A link **MUST** be represented as either: a string
 containing the link's URL or a link object.
 oneOf:
 - description: A string containing the link's URL.
 type: string
 format: uri
 - type: object
 required:
 - href
 properties:
 href:
 description: A string containing the link's URL.
 type: string
 format: uri
 meta:
 description: >-
 Non-standard meta-information that can not be
 represented as an attribute or relationship.
 type: object
 additionalProperties: true
 additionalProperties: true
 status:
 description: >-
 The HTTP status code applicable to this problem, expressed as
 a string value.
 type: string
 code:
 description: >-
 An application-specific error code, expressed as a string
 value.
 type: string
 title:
 description: >-
 A short, human-readable summary of the problem. It **SHOULD
 NOT** change from occurrence to occurrence of the problem,
 except for purposes of localization.
 type: string
 detail:
 description: >-
 A human-readable explanation specific to this occurrence of
 the problem.
 type: string
 source:
 type: object
 properties:
 pointer:
 description: >-
 A JSON Pointer [RFC6901] to the associated entity in the
 request document [e.g. "/data" for a primary data object,
 or "/data/attributes/title" for a specific attribute].
 type: string
 parameter:
 description: >-
 A string indicating which query parameter caused the
 error.
 type: string
 meta:
 description: >-
 Non-standard meta-information that can not be represented as
 an attribute or relationship.
 type: object
 additionalProperties: true
 additionalProperties: false
 uniqueItems: true
 meta:
 description: >-
 Non-standard meta-information that can not be represented as an
 attribute or relationship.
 type: object
 additionalProperties: true
 links:
 description: >-
 A resource object **MAY** contain references to other resource
 objects ("relationships"). Relationships may be to-one or to-many.
 Relationships can be specified by including a member in a resource's
 links object.
 type: object
 properties:
 self:
 description: >-
 A `self` member, whose value is a URL for the relationship
 itself (a "relationship URL"). This URL allows the client to
 directly manipulate the relationship. For example, it would
 allow a client to remove an `author` from an `article` without
 deleting the people resource itself.
 type: string
 format: uri
 related:
 description: >-
 A link **MUST** be represented as either: a string containing
 the link's URL or a link object.
 oneOf:
 - description: A string containing the link's URL.
 type: string
 format: uri
 - type: object
 required:
 - href
 properties:
 href:
 description: A string containing the link's URL.
 type: string
 format: uri
 meta:
 description: >-
 Non-standard meta-information that can not be
 represented as an attribute or relationship.
 type: object
 additionalProperties: true
 additionalProperties: true
 additionalProperties: false
 PutDocumentResponse:
 title: Empty Schema
 type: object
 PutDocumentRequest:
 properties:
 SomeObject:
 type: object
 properties:
 SomeAttribute:
 type: string
 securitySchemes: {}
info:
 title: ''
 description: ''
 version: e9860c9e-d888-47fc-9068-6094d45e0550
paths:
 '/create/{username}':
 post:
 operationId: createUser
 summary: Create User
 description: Creates a user and then sends a generated password email
 requestBody:
 content:
 application/json:
 schema:
 $ref: '#/components/schemas/PutDocumentRequest'
 description: A user information object
 parameters:
 - name: username
 in: path
 description: The username for a user to create
 required: true
 schema:
 type: string
 pattern: '^[-a-z0-9_]+$'
 - name: membershipType
 in: query
 description: The user's Membership Type
 required: false
 allowEmptyValue: false
 schema:
 type: string
 enum:
 - premium
 - standard
 - name: SessionId
 in: cookie
 description: A Session ID variable
 required: false
 schema:
 type: string
 responses:
 '201':
 description: A user object along with generated API Keys
 content:
 application/json:
 schema:
 $ref: '#/components/schemas/PutDocumentResponse'
 '500':
 description: An error message when creating a new user
 content:
 application/json:
 schema:
 $ref: '#/components/schemas/ErrorResponse'