lib/swagger/devops-vernonkeenan.yaml

1832 lines
46 KiB
YAML
Raw Permalink Normal View History

2021-07-31 03:05:02 +00:00
swagger: "2.0"
info:
2021-08-05 19:37:53 +00:00
version: 0.0.1
2021-07-31 03:05:02 +00:00
title: "devops"
description: "System Operations Microservice"
2021-08-05 19:37:53 +00:00
termsOfService: "http://taxnexus.net/terms/"
2021-07-31 03:05:02 +00:00
contact:
2021-08-05 19:37:53 +00:00
email: "noc@taxnexus.net"
2021-07-31 03:05:02 +00:00
license:
2021-08-05 19:37:53 +00:00
name: "Proprietary - Copyright (c) 2018-2021 by Taxnexus, Inc."
2021-07-31 03:05:02 +00:00
securityDefinitions:
ApiKeyAuth:
type: "apiKey"
in: "header"
name: "X-API-Key"
schemes:
- "http"
basePath: "/v1"
2021-08-16 17:36:44 +00:00
host: "devops.vernonkeenan.com:8080"
2021-07-31 03:05:02 +00:00
consumes:
- "application/json"
produces:
- "application/json"
parameters:
databaseIdQuery:
2021-08-05 19:37:53 +00:00
description: Taxnexus Record Id of a Database
2021-07-31 03:05:02 +00:00
in: query
name: databaseId
required: false
type: string
2021-08-05 19:37:53 +00:00
taxnexusAccountQuery:
description: Taxnexus Account of a Tenant
2021-07-31 03:05:02 +00:00
in: query
2021-08-05 19:37:53 +00:00
name: taxnexusAccount
2021-07-31 03:05:02 +00:00
required: false
type: string
tenantIdQuery:
2021-08-05 19:37:53 +00:00
description: Taxnexus Record Id of a Tenant
2021-07-31 03:05:02 +00:00
in: query
name: tenantId
required: false
type: string
tenantRequest:
description: An array of Tenant records
in: body
name: TenantRequest
required: true
schema:
$ref: "#/definitions/TenantRequest"
databaseRequest:
description: An array of Database records
in: body
name: DatabaseRequest
required: true
schema:
$ref: "#/definitions/DatabaseRequest"
X-API-Key:
name: X-API-Key
in: "header"
required: true
type: string
ClusterRequest:
description: An array of Cluster records
in: body
name: ClusterRequest
required: true
schema:
$ref: "#/definitions/ClusterRequest"
TemplateRequest:
description: An array of Template records
in: body
name: TemplateRequest
required: true
schema:
$ref: "#/definitions/TemplateRequest"
UserRequest:
description: An array of User records
in: body
name: UserRequest
required: true
schema:
$ref: "#/definitions/UserRequest"
accountIdQuery:
2021-08-05 19:37:53 +00:00
description: Taxnexus Record Id of an Account
2021-07-31 03:05:02 +00:00
in: query
name: accountId
required: false
type: string
contactIdQuery:
2021-08-05 19:37:53 +00:00
description: Taxnexus Record Id of a Contact
2021-07-31 03:05:02 +00:00
in: query
name: contactId
required: false
type: string
accountNumberQuery:
description:
2021-08-05 19:37:53 +00:00
The Taxnexus Account Number of the Account to be used a record
2021-07-31 03:05:02 +00:00
retrieval
in: query
name: accountNumber
required: false
type: string
activeQuery:
description: Retrieve active records only?
in: query
name: active
required: false
type: boolean
apiKeyQuery:
description: Service account or developer API key
in: query
name: apikey
type: string
clusterIdPath:
2021-08-05 19:37:53 +00:00
description: Taxnexus Record Id of a Cluster
2021-07-31 03:05:02 +00:00
in: path
name: clusterIdPath
type: string
required: true
databaseIdPath:
2021-08-05 19:37:53 +00:00
description: Taxnexus Record Id of a Database
2021-07-31 03:05:02 +00:00
in: path
name: databaseIdPath
type: string
required: true
clusterIdQuery:
2021-08-05 19:37:53 +00:00
description: Taxnexus Record Id of a Cluster
2021-07-31 03:05:02 +00:00
in: query
name: clusterId
required: false
type: string
companyIdQuery:
2021-08-05 19:37:53 +00:00
description: Taxnexus Record Id of a Company
2021-07-31 03:05:02 +00:00
in: query
name: companyId
required: false
type: string
ingestIdPath:
2021-08-05 19:37:53 +00:00
description: Taxnexus Record Id of a Ingest
2021-07-31 03:05:02 +00:00
in: path
name: ingestIdPath
type: string
required: true
ingestIdQuery:
2021-08-05 19:37:53 +00:00
description: Taxnexus Record Id of an Ingest
2021-07-31 03:05:02 +00:00
in: query
name: ingestId
required: false
type: string
jobIdPath:
2021-08-05 19:37:53 +00:00
description: Taxnexus Record Id of a Job
2021-07-31 03:05:02 +00:00
in: path
name: jobIdPath
type: string
required: true
jobIdQuery:
2021-08-05 19:37:53 +00:00
description: Taxnexus Record Id of a Job
2021-07-31 03:05:02 +00:00
in: query
name: jobId
required: false
type: string
limitQuery:
description: "How many objects to return at one time"
format: int64
in: query
name: limit
required: false
type: integer
offsetQuery:
description: How many objects to skip? (default 0)
format: int64
in: query
name: offset
required: false
type: integer
serviceIdPath:
2021-08-05 19:37:53 +00:00
description: Taxnexus Record Id of a Service
2021-07-31 03:05:02 +00:00
in: path
name: serviceIdPath
type: string
required: true
serviceIdQuery:
description: Service ID
in: query
name: serviceId
type: string
templateIdPath:
2021-08-05 19:37:53 +00:00
description: Taxnexus Record Id of a Template
2021-07-31 03:05:02 +00:00
in: path
name: templateIdPath
type: string
required: true
templateIdQuery:
description: Template ID
in: query
name: templateId
type: string
objectTypeQuery:
description: Object Type Name
in: query
name: objectType
type: string
isMasterQuery:
description: Is Master Template?
in: query
name: isMaster
type: boolean
userIdPath:
2021-08-05 19:37:53 +00:00
description: Taxnexus Record Id of a User
2021-07-31 03:05:02 +00:00
in: path
name: userIdPath
type: string
required: true
tenantIdPath:
2021-08-05 19:37:53 +00:00
description: Taxnexus Record Id of a Tenant
2021-07-31 03:05:02 +00:00
in: path
name: tenantIdPath
type: string
required: true
userIdQuery:
2021-08-05 19:37:53 +00:00
description: Taxnexus User ID (unique)
2021-07-31 03:05:02 +00:00
in: query
name: userId
type: string
emailQuery:
description: Email Address (not unique)
in: query
name: email
type: string
usernameQuery:
description: Username (unique)
in: query
name: username
type: string
userRequest:
description: An array of user records
in: body
name: UserRequest
required: true
schema:
$ref: "#/definitions/UserRequest"
responses:
AccessForbidden:
description: "Access forbidden, account lacks access"
headers:
Access-Control-Allow-Origin:
type: string
schema:
$ref: "#/definitions/Error"
ClusterSingletonResponse:
description: Single Cluster record response
headers:
Access-Control-Allow-Origin:
type: string
Cache-Control:
type: string
schema:
$ref: "#/definitions/Cluster"
ClusterObservableResponse:
description: Single Cluster record response
headers:
Access-Control-Allow-Origin:
type: string
Cache-Control:
type: string
schema:
type: array
items:
$ref: "#/definitions/Cluster"
ClusterResponse:
2021-08-05 19:37:53 +00:00
description: Taxnexus Response with Cluster objects
2021-07-31 03:05:02 +00:00
headers:
Access-Control-Allow-Origin:
type: string
Cache-Control:
type: string
schema:
$ref: "#/definitions/ClusterResponse"
DeveopsDeleteResponse:
description:
2021-08-05 19:37:53 +00:00
Taxnexus Response with Message Objects with Delete Status
2021-07-31 03:05:02 +00:00
headers:
Access-Control-Allow-Origin:
type: string
schema:
$ref: "#/definitions/DeleteResponse"
NotFound:
headers:
Access-Control-Allow-Origin:
type: string
description: Resource was not found
schema:
$ref: "#/definitions/Error"
DatabaseResponse:
headers:
Access-Control-Allow-Origin:
type: string
2021-08-05 19:37:53 +00:00
description: Taxnexus Response with Database objects
2021-07-31 03:05:02 +00:00
schema:
$ref: "#/definitions/DatabaseResponse"
DatabaseSingletonResponse:
description: Single Database record response
headers:
Access-Control-Allow-Origin:
type: string
Cache-Control:
type: string
schema:
$ref: "#/definitions/Database"
DatabaseObservableResponse:
description: Single Database record response
headers:
Access-Control-Allow-Origin:
type: string
Cache-Control:
type: string
schema:
type: array
items:
$ref: "#/definitions/Database"
TenantResponse:
headers:
Access-Control-Allow-Origin:
type: string
2021-08-05 19:37:53 +00:00
description: Taxnexus Response with Tenant objects
2021-07-31 03:05:02 +00:00
schema:
$ref: "#/definitions/TenantResponse"
TenantSingletonResponse:
description: Single Tenant record response
headers:
Access-Control-Allow-Origin:
type: string
Cache-Control:
type: string
schema:
$ref: "#/definitions/Tenant"
TenantObservableResponse:
description: Single Tenant record response
headers:
Access-Control-Allow-Origin:
type: string
Cache-Control:
type: string
schema:
type: array
items:
$ref: "#/definitions/Tenant"
ServerError:
headers:
Access-Control-Allow-Origin:
type: string
description: Server Internal Error
schema:
$ref: "#/definitions/Error"
TemplateResponse:
2021-08-05 19:37:53 +00:00
description: Taxnexus Response with Template objects
2021-07-31 03:05:02 +00:00
headers:
Access-Control-Allow-Origin:
type: string
Cache-Control:
type: string
schema:
$ref: "#/definitions/TemplateResponse"
TemplateSingletonResponse:
description: Single Template record response
headers:
Access-Control-Allow-Origin:
type: string
Cache-Control:
type: string
schema:
$ref: "#/definitions/Template"
TemplateObservableResponse:
description: Simple Template record response
headers:
Access-Control-Allow-Origin:
type: string
Cache-Control:
type: string
schema:
type: array
items:
$ref: "#/definitions/Template"
Unauthorized:
description: "Access Unauthorized, invalid API-KEY was used"
headers:
Access-Control-Allow-Origin:
type: string
Cache-Control:
type: string
schema:
$ref: "#/definitions/Error"
UnprocessableEntity:
description: "Unprocessable Entity, likely a bad parameter"
headers:
Access-Control-Allow-Origin:
type: string
Cache-Control:
type: string
schema:
$ref: "#/definitions/Error"
UserResponse:
2021-08-05 19:37:53 +00:00
description: Taxnexus Response with User objects
2021-07-31 03:05:02 +00:00
headers:
Access-Control-Allow-Origin:
type: string
Cache-Control:
type: string
schema:
$ref: "#/definitions/UserResponse"
UserSingletonResponse:
description: Single User record response
headers:
Access-Control-Allow-Origin:
type: string
Cache-Control:
type: string
schema:
$ref: "#/definitions/User"
UserObservableResponse:
description: Simple User record response
headers:
Access-Control-Allow-Origin:
type: string
Cache-Control:
type: string
schema:
type: array
items:
$ref: "#/definitions/User"
CORSResponse:
description: CORS OPTIONS response
headers:
Access-Control-Allow-Origin:
type: string
Access-Control-Allow-Headers:
type: string
Access-Control-Allow-Methods:
type: string
Access-Control-Expose-Headers:
type: string
Access-Control-Max-Age:
type: string
Access-Control-Allow-Credentials:
type: string
Cache-Control:
type: string
paths:
/clusters:
get:
description: Return a list of Cluster records from the datastore
operationId: getClusters
parameters:
- $ref: "#/parameters/clusterIdQuery"
- $ref: "#/parameters/companyIdQuery"
- $ref: "#/parameters/limitQuery"
- $ref: "#/parameters/offsetQuery"
responses:
"200":
$ref: "#/responses/ClusterResponse"
"401":
$ref: "#/responses/Unauthorized"
"403":
$ref: "#/responses/AccessForbidden"
"404":
$ref: "#/responses/NotFound"
"422":
$ref: "#/responses/UnprocessableEntity"
"500":
$ref: "#/responses/ServerError"
security:
- ApiKeyAuth: []
summary: Get a list Clusters
tags:
- Cluster
options:
description: CORS support
operationId: clustersOptions
responses:
"200":
$ref: "#/responses/CORSResponse"
tags:
- cors
post:
2021-08-05 19:37:53 +00:00
description: Create Clusters in Taxnexus
2021-07-31 03:05:02 +00:00
operationId: postClusters
parameters:
- $ref: "#/parameters/ClusterRequest"
responses:
"200":
$ref: "#/responses/ClusterResponse"
"401":
$ref: "#/responses/Unauthorized"
"403":
$ref: "#/responses/AccessForbidden"
"404":
$ref: "#/responses/NotFound"
"422":
$ref: "#/responses/UnprocessableEntity"
"500":
$ref: "#/responses/ServerError"
security:
- ApiKeyAuth: []
summary: Create new Clusters
tags:
- Cluster
put:
2021-08-05 19:37:53 +00:00
description: Update Cluster in Taxnexus
2021-07-31 03:05:02 +00:00
operationId: putClusters
parameters:
- $ref: "#/parameters/ClusterRequest"
responses:
"200":
$ref: "#/responses/ClusterResponse"
"401":
$ref: "#/responses/Unauthorized"
"403":
$ref: "#/responses/AccessForbidden"
"404":
$ref: "#/responses/NotFound"
"422":
$ref: "#/responses/UnprocessableEntity"
"500":
$ref: "#/responses/ServerError"
security:
- ApiKeyAuth: []
summary: Update Clustera
tags:
- Cluster
/clusters/observable:
get:
description: Returns a Cluster retrieval in a observable array
operationId: getClustersObservable
responses:
"200":
$ref: "#/responses/ClusterObservableResponse"
"401":
$ref: "#/responses/Unauthorized"
"403":
$ref: "#/responses/AccessForbidden"
"404":
$ref: "#/responses/NotFound"
"422":
$ref: "#/responses/UnprocessableEntity"
"500":
$ref: "#/responses/ServerError"
security:
- ApiKeyAuth: []
summary: Get Clusters in an observable array
tags:
- Cluster
options:
description: CORS support
operationId: clusterOptions
responses:
"200":
$ref: "#/responses/CORSResponse"
tags:
- cors
"/clusters/{clusterIdPath}":
get:
description:
Return a single Cluster object from datastore as a Singleton
operationId: getCluster
parameters:
- $ref: "#/parameters/clusterIdPath"
responses:
"200":
$ref: "#/responses/ClusterSingletonResponse"
"401":
$ref: "#/responses/Unauthorized"
"403":
$ref: "#/responses/AccessForbidden"
"404":
$ref: "#/responses/NotFound"
"422":
$ref: "#/responses/UnprocessableEntity"
"500":
$ref: "#/responses/ServerError"
security:
- ApiKeyAuth: []
summary: Get a single Cluster object
tags:
- Cluster
/databases:
get:
description: Return a list of Database records from the datastore
operationId: getDatabases
parameters:
- $ref: "#/parameters/databaseIdQuery"
- $ref: "#/parameters/companyIdQuery"
- $ref: "#/parameters/limitQuery"
- $ref: "#/parameters/offsetQuery"
responses:
"200":
$ref: "#/responses/DatabaseResponse"
"401":
$ref: "#/responses/Unauthorized"
"403":
$ref: "#/responses/AccessForbidden"
"404":
$ref: "#/responses/NotFound"
"422":
$ref: "#/responses/UnprocessableEntity"
"500":
$ref: "#/responses/ServerError"
security:
- ApiKeyAuth: []
summary: Get a list Databases
tags:
- Database
options:
description: CORS support
operationId: databasesOptions
responses:
"200":
$ref: "#/responses/CORSResponse"
tags:
- cors
post:
2021-08-05 19:37:53 +00:00
description: Create Databases in Taxnexus
2021-07-31 03:05:02 +00:00
operationId: postDatabases
parameters:
- $ref: "#/parameters/databaseRequest"
responses:
"200":
$ref: "#/responses/DatabaseResponse"
"401":
$ref: "#/responses/Unauthorized"
"403":
$ref: "#/responses/AccessForbidden"
"404":
$ref: "#/responses/NotFound"
"422":
$ref: "#/responses/UnprocessableEntity"
"500":
$ref: "#/responses/ServerError"
security:
- ApiKeyAuth: []
summary: Create new Databases
tags:
- Database
put:
2021-08-05 19:37:53 +00:00
description: Update Database in Taxnexus
2021-07-31 03:05:02 +00:00
operationId: putDatabases
parameters:
- $ref: "#/parameters/databaseRequest"
responses:
"200":
$ref: "#/responses/DatabaseResponse"
"401":
$ref: "#/responses/Unauthorized"
"403":
$ref: "#/responses/AccessForbidden"
"404":
$ref: "#/responses/NotFound"
"422":
$ref: "#/responses/UnprocessableEntity"
"500":
$ref: "#/responses/ServerError"
security:
- ApiKeyAuth: []
summary: Update Databases
tags:
- Database
/databases/observable:
get:
description: Returns a Database retrieval in a observable array
operationId: getDatabasesObservable
responses:
"200":
$ref: "#/responses/DatabaseObservableResponse"
"401":
$ref: "#/responses/Unauthorized"
"403":
$ref: "#/responses/AccessForbidden"
"404":
$ref: "#/responses/NotFound"
"422":
$ref: "#/responses/UnprocessableEntity"
"500":
$ref: "#/responses/ServerError"
security:
- ApiKeyAuth: []
summary: Get Databases in an observable array
tags:
- Database
options:
description: CORS support
operationId: databaseOptions
responses:
"200":
$ref: "#/responses/CORSResponse"
tags:
- cors
"/databases/{databaseIdPath}":
get:
description:
Return a single Database object from datastore as a Singleton
operationId: getDatabase
parameters:
- $ref: "#/parameters/databaseIdPath"
responses:
"200":
$ref: "#/responses/DatabaseSingletonResponse"
"401":
$ref: "#/responses/Unauthorized"
"403":
$ref: "#/responses/AccessForbidden"
"404":
$ref: "#/responses/NotFound"
"422":
$ref: "#/responses/UnprocessableEntity"
"500":
$ref: "#/responses/ServerError"
security:
- ApiKeyAuth: []
summary: Get a single Database object
tags:
- Database
2021-08-06 02:21:34 +00:00
/templates:
2021-07-31 03:05:02 +00:00
get:
2021-08-06 02:21:34 +00:00
description: Return a list of Templates from the datastore
operationId: getTemplates
2021-07-31 03:05:02 +00:00
parameters:
- $ref: "#/parameters/limitQuery"
- $ref: "#/parameters/offsetQuery"
2021-08-06 02:21:34 +00:00
- $ref: "#/parameters/activeQuery"
- $ref: "#/parameters/templateIdQuery"
- $ref: "#/parameters/isMasterQuery"
- $ref: "#/parameters/objectTypeQuery"
2021-07-31 03:05:02 +00:00
responses:
"200":
2021-08-06 02:21:34 +00:00
$ref: "#/responses/TemplateResponse"
2021-07-31 03:05:02 +00:00
"401":
$ref: "#/responses/Unauthorized"
"403":
$ref: "#/responses/AccessForbidden"
"404":
$ref: "#/responses/NotFound"
"422":
$ref: "#/responses/UnprocessableEntity"
"500":
$ref: "#/responses/ServerError"
security:
- ApiKeyAuth: []
2021-08-06 02:21:34 +00:00
summary: Get a list Templates
2021-07-31 03:05:02 +00:00
tags:
2021-08-06 02:21:34 +00:00
- Template
2021-07-31 03:05:02 +00:00
options:
description: CORS support
2021-08-06 02:21:34 +00:00
operationId: templatesOptions
2021-07-31 03:05:02 +00:00
responses:
"200":
$ref: "#/responses/CORSResponse"
tags:
- cors
post:
2021-08-06 02:21:34 +00:00
description: Create new Templates
operationId: postTemplates
2021-07-31 03:05:02 +00:00
parameters:
2021-08-06 02:21:34 +00:00
- $ref: "#/parameters/TemplateRequest"
2021-07-31 03:05:02 +00:00
responses:
"200":
2021-08-06 02:21:34 +00:00
$ref: "#/responses/TemplateResponse"
2021-07-31 03:05:02 +00:00
"401":
$ref: "#/responses/Unauthorized"
"403":
$ref: "#/responses/AccessForbidden"
"404":
$ref: "#/responses/NotFound"
"422":
$ref: "#/responses/UnprocessableEntity"
"500":
$ref: "#/responses/ServerError"
security:
- ApiKeyAuth: []
2021-08-06 02:21:34 +00:00
summary: Create new Templates
2021-07-31 03:05:02 +00:00
tags:
2021-08-06 02:21:34 +00:00
- Template
/templates/observable:
2021-07-31 03:05:02 +00:00
get:
2021-08-06 02:21:34 +00:00
description: Returns a Template retrieval in a observable array
operationId: getTemplatesObservable
2021-07-31 03:05:02 +00:00
responses:
"200":
2021-08-06 02:21:34 +00:00
$ref: "#/responses/TemplateObservableResponse"
2021-07-31 03:05:02 +00:00
"401":
$ref: "#/responses/Unauthorized"
"403":
$ref: "#/responses/AccessForbidden"
"404":
$ref: "#/responses/NotFound"
"422":
$ref: "#/responses/UnprocessableEntity"
"500":
$ref: "#/responses/ServerError"
security:
- ApiKeyAuth: []
2021-08-06 02:21:34 +00:00
summary: Get Templates in an observable array
2021-07-31 03:05:02 +00:00
tags:
2021-08-06 02:21:34 +00:00
- Template
2021-07-31 03:05:02 +00:00
options:
description: CORS support
2021-08-06 02:21:34 +00:00
operationId: templateOptions
2021-07-31 03:05:02 +00:00
responses:
"200":
$ref: "#/responses/CORSResponse"
tags:
- cors
2021-08-06 02:21:34 +00:00
"/templates/{templateIdPath}":
2021-07-31 03:05:02 +00:00
get:
description:
2021-08-06 02:21:34 +00:00
Return a single Template object from datastore as a Singleton
operationId: getTemplate
2021-07-31 03:05:02 +00:00
parameters:
2021-08-06 02:21:34 +00:00
- $ref: "#/parameters/templateIdPath"
2021-07-31 03:05:02 +00:00
responses:
"200":
2021-08-06 02:21:34 +00:00
$ref: "#/responses/TemplateSingletonResponse"
2021-07-31 03:05:02 +00:00
"401":
$ref: "#/responses/Unauthorized"
"403":
$ref: "#/responses/AccessForbidden"
"404":
$ref: "#/responses/NotFound"
"422":
$ref: "#/responses/UnprocessableEntity"
"500":
$ref: "#/responses/ServerError"
security:
- ApiKeyAuth: []
2021-08-06 02:21:34 +00:00
summary: Get a single Template object
2021-07-31 03:05:02 +00:00
tags:
2021-08-06 02:21:34 +00:00
- Template
/tenants:
2021-07-31 03:05:02 +00:00
get:
2021-08-06 02:21:34 +00:00
description: Return a list of Tenant records from the datastore
operationId: getTenants
2021-07-31 03:05:02 +00:00
parameters:
2021-08-06 02:21:34 +00:00
- $ref: "#/parameters/taxnexusAccountQuery"
- $ref: "#/parameters/tenantIdQuery"
2021-07-31 03:05:02 +00:00
- $ref: "#/parameters/companyIdQuery"
- $ref: "#/parameters/limitQuery"
- $ref: "#/parameters/offsetQuery"
responses:
"200":
2021-08-06 02:21:34 +00:00
$ref: "#/responses/TenantResponse"
2021-07-31 03:05:02 +00:00
"401":
$ref: "#/responses/Unauthorized"
"403":
$ref: "#/responses/AccessForbidden"
"404":
$ref: "#/responses/NotFound"
"422":
$ref: "#/responses/UnprocessableEntity"
"500":
$ref: "#/responses/ServerError"
security:
- ApiKeyAuth: []
2021-08-06 02:21:34 +00:00
summary: Get a list Tenants
2021-07-31 03:05:02 +00:00
tags:
2021-08-06 02:21:34 +00:00
- Tenant
2021-07-31 03:05:02 +00:00
options:
description: CORS support
2021-08-06 02:21:34 +00:00
operationId: tenantsOptions
2021-07-31 03:05:02 +00:00
responses:
"200":
$ref: "#/responses/CORSResponse"
tags:
- cors
post:
2021-08-06 02:21:34 +00:00
description: Create Tenants in Taxnexus
operationId: postTenants
2021-07-31 03:05:02 +00:00
parameters:
2021-08-06 02:21:34 +00:00
- $ref: "#/parameters/tenantRequest"
2021-07-31 03:05:02 +00:00
responses:
"200":
2021-08-06 02:21:34 +00:00
$ref: "#/responses/TenantResponse"
2021-07-31 03:05:02 +00:00
"401":
$ref: "#/responses/Unauthorized"
"403":
$ref: "#/responses/AccessForbidden"
"404":
$ref: "#/responses/NotFound"
"422":
$ref: "#/responses/UnprocessableEntity"
"500":
$ref: "#/responses/ServerError"
security:
- ApiKeyAuth: []
2021-08-06 02:21:34 +00:00
summary: Create new Tenants
2021-07-31 03:05:02 +00:00
tags:
2021-08-06 02:21:34 +00:00
- Tenant
2021-07-31 03:05:02 +00:00
put:
2021-08-06 02:21:34 +00:00
description: Update Tenant in Taxnexus
operationId: putTenants
2021-07-31 03:05:02 +00:00
parameters:
2021-08-06 02:21:34 +00:00
- $ref: "#/parameters/tenantRequest"
2021-07-31 03:05:02 +00:00
responses:
"200":
2021-08-06 02:21:34 +00:00
$ref: "#/responses/TenantResponse"
2021-07-31 03:05:02 +00:00
"401":
$ref: "#/responses/Unauthorized"
"403":
$ref: "#/responses/AccessForbidden"
"404":
$ref: "#/responses/NotFound"
"422":
$ref: "#/responses/UnprocessableEntity"
"500":
$ref: "#/responses/ServerError"
security:
- ApiKeyAuth: []
2021-08-06 02:21:34 +00:00
summary: Update Tenants
2021-07-31 03:05:02 +00:00
tags:
2021-08-06 02:21:34 +00:00
- Tenant
/tenants/observable:
2021-07-31 03:05:02 +00:00
get:
2021-08-06 02:21:34 +00:00
description: Returns a Tenant retrieval in a observable array
operationId: getTenantsObservable
2021-07-31 03:05:02 +00:00
responses:
"200":
2021-08-06 02:21:34 +00:00
$ref: "#/responses/TenantObservableResponse"
2021-07-31 03:05:02 +00:00
"401":
$ref: "#/responses/Unauthorized"
"403":
$ref: "#/responses/AccessForbidden"
"404":
$ref: "#/responses/NotFound"
"422":
$ref: "#/responses/UnprocessableEntity"
"500":
$ref: "#/responses/ServerError"
security:
- ApiKeyAuth: []
2021-08-06 02:21:34 +00:00
summary: Get Tenants in an observable array
2021-07-31 03:05:02 +00:00
tags:
2021-08-06 02:21:34 +00:00
- Tenant
2021-07-31 03:05:02 +00:00
options:
description: CORS support
2021-08-06 02:21:34 +00:00
operationId: tenantOptions
2021-07-31 03:05:02 +00:00
responses:
"200":
$ref: "#/responses/CORSResponse"
tags:
- cors
2021-08-06 02:21:34 +00:00
"/tenants/{tenantIdPath}":
2021-07-31 03:05:02 +00:00
get:
description:
2021-08-06 02:21:34 +00:00
Return a single Tenant object from datastore as a Singleton
operationId: getTenant
2021-07-31 03:05:02 +00:00
parameters:
2021-08-06 02:21:34 +00:00
- $ref: "#/parameters/tenantIdPath"
2021-07-31 03:05:02 +00:00
responses:
"200":
2021-08-06 02:21:34 +00:00
$ref: "#/responses/TenantSingletonResponse"
2021-07-31 03:05:02 +00:00
"401":
$ref: "#/responses/Unauthorized"
"403":
$ref: "#/responses/AccessForbidden"
"404":
$ref: "#/responses/NotFound"
"422":
$ref: "#/responses/UnprocessableEntity"
"500":
$ref: "#/responses/ServerError"
security:
- ApiKeyAuth: []
2021-08-06 02:21:34 +00:00
summary: Get a single Tenant object
2021-07-31 03:05:02 +00:00
tags:
2021-08-06 02:21:34 +00:00
- Tenant
/users:
2021-07-31 03:05:02 +00:00
get:
2021-08-06 02:21:34 +00:00
description: Return a list of User records from the datastore
operationId: getUsers
2021-07-31 03:05:02 +00:00
parameters:
- $ref: "#/parameters/limitQuery"
- $ref: "#/parameters/offsetQuery"
2021-08-06 02:21:34 +00:00
- $ref: "#/parameters/accountIdQuery"
- $ref: "#/parameters/contactIdQuery"
- $ref: "#/parameters/activeQuery"
- $ref: "#/parameters/emailQuery"
- $ref: "#/parameters/userIdQuery"
- $ref: "#/parameters/usernameQuery"
2021-07-31 03:05:02 +00:00
responses:
"200":
2021-08-06 02:21:34 +00:00
$ref: "#/responses/UserResponse"
2021-07-31 03:05:02 +00:00
"401":
$ref: "#/responses/Unauthorized"
"403":
$ref: "#/responses/AccessForbidden"
"404":
$ref: "#/responses/NotFound"
"422":
$ref: "#/responses/UnprocessableEntity"
"500":
$ref: "#/responses/ServerError"
security:
- ApiKeyAuth: []
2021-08-06 02:21:34 +00:00
summary: Get a list Users
2021-07-31 03:05:02 +00:00
tags:
2021-08-06 02:21:34 +00:00
- User
2021-07-31 03:05:02 +00:00
options:
description: CORS support
2021-08-06 02:21:34 +00:00
operationId: usersOptions
2021-07-31 03:05:02 +00:00
responses:
"200":
$ref: "#/responses/CORSResponse"
tags:
- cors
post:
2021-08-06 02:21:34 +00:00
description: Create new Users
operationId: postUsers
2021-07-31 03:05:02 +00:00
parameters:
2021-08-06 02:21:34 +00:00
- $ref: "#/parameters/UserRequest"
2021-07-31 03:05:02 +00:00
responses:
"200":
2021-08-06 02:21:34 +00:00
$ref: "#/responses/UserResponse"
2021-07-31 03:05:02 +00:00
"401":
$ref: "#/responses/Unauthorized"
"403":
$ref: "#/responses/AccessForbidden"
"404":
$ref: "#/responses/NotFound"
"422":
$ref: "#/responses/UnprocessableEntity"
"500":
$ref: "#/responses/ServerError"
security:
- ApiKeyAuth: []
2021-08-06 02:21:34 +00:00
summary: Create new Users
2021-07-31 03:05:02 +00:00
tags:
2021-08-06 02:21:34 +00:00
- User
2021-07-31 03:05:02 +00:00
put:
2021-08-06 02:21:34 +00:00
description: Update existing users
operationId: putUsers
2021-07-31 03:05:02 +00:00
parameters:
2021-08-06 02:21:34 +00:00
- $ref: "#/parameters/UserRequest"
2021-07-31 03:05:02 +00:00
responses:
"200":
2021-08-06 02:21:34 +00:00
$ref: "#/responses/UserResponse"
2021-07-31 03:05:02 +00:00
"401":
$ref: "#/responses/Unauthorized"
"403":
$ref: "#/responses/AccessForbidden"
"404":
$ref: "#/responses/NotFound"
"422":
$ref: "#/responses/UnprocessableEntity"
"500":
$ref: "#/responses/ServerError"
security:
- ApiKeyAuth: []
2021-08-06 02:21:34 +00:00
summary: Update existing users
2021-07-31 03:05:02 +00:00
tags:
2021-08-06 02:21:34 +00:00
- User
/users/observable:
2021-07-31 03:05:02 +00:00
get:
2021-08-06 02:21:34 +00:00
description: Returns a User retrieval in a observable array
operationId: getUsersObservable
2021-07-31 03:05:02 +00:00
responses:
"200":
2021-08-06 02:21:34 +00:00
$ref: "#/responses/UserObservableResponse"
2021-07-31 03:05:02 +00:00
"401":
$ref: "#/responses/Unauthorized"
"403":
$ref: "#/responses/AccessForbidden"
"404":
$ref: "#/responses/NotFound"
"422":
$ref: "#/responses/UnprocessableEntity"
"500":
$ref: "#/responses/ServerError"
security:
- ApiKeyAuth: []
2021-08-06 02:21:34 +00:00
summary: Get Users in an observable array
2021-07-31 03:05:02 +00:00
tags:
2021-08-06 02:21:34 +00:00
- User
2021-07-31 03:05:02 +00:00
options:
description: CORS support
2021-08-06 02:21:34 +00:00
operationId: userOptions
2021-07-31 03:05:02 +00:00
responses:
"200":
$ref: "#/responses/CORSResponse"
tags:
- cors
2021-08-06 02:21:34 +00:00
"/users/{userIdPath}":
2021-07-31 03:05:02 +00:00
get:
description:
2021-08-06 02:21:34 +00:00
Return a single User object from datastore as a Singleton
operationId: getUser
2021-07-31 03:05:02 +00:00
parameters:
2021-08-06 02:21:34 +00:00
- $ref: "#/parameters/userIdPath"
2021-07-31 03:05:02 +00:00
responses:
"200":
2021-08-06 02:21:34 +00:00
$ref: "#/responses/UserSingletonResponse"
2021-07-31 03:05:02 +00:00
"401":
$ref: "#/responses/Unauthorized"
"403":
$ref: "#/responses/AccessForbidden"
"404":
$ref: "#/responses/NotFound"
"422":
$ref: "#/responses/UnprocessableEntity"
"500":
$ref: "#/responses/ServerError"
security:
- ApiKeyAuth: []
2021-08-06 02:21:34 +00:00
summary: Get a single User object
2021-07-31 03:05:02 +00:00
tags:
- User
definitions:
Address:
properties:
City:
description: City
type: string
Country:
description: Country full name
type: string
CountryCode:
description: Country Code
type: string
PostalCode:
description: Postal Code
type: string
State:
description: State full name
type: string
StateCode:
description: State Code
type: string
Street:
description: Street number and name
type: string
type: object
Cluster:
properties:
CreatedByID:
description: Created By
type: string
CreatedDate:
description: Created Date
type: string
Description:
description: Description
type: string
Environment:
description: Environment
type: string
Gateway:
description: Gateway
type: string
ID:
2021-08-05 19:37:53 +00:00
description: Taxnexus Record Id
2021-07-31 03:05:02 +00:00
type: string
IPAddress:
description: IP Address
type: string
LastModifiedByID:
description: Last Modified By
type: string
LastModifiedDate:
description: Last Modified Date
type: string
Name:
description: Cluster Name
type: string
OwnerID:
description: Owner
type: string
Ref:
description: External Reference
type: string
Status:
description: Status
type: string
Subnet:
description: Subnet
type: string
Type:
description: Type
type: string
TenantID:
description: The ID of the tenant who owns this Database
type: string
Zone:
description: Zone
type: string
type: object
ClusterRequest:
properties:
Data:
items:
$ref: "#/definitions/Cluster"
type: array
type: object
ClusterResponse:
description: An array of cluster objects
properties:
Data:
items:
$ref: "#/definitions/Cluster"
type: array
Meta:
$ref: "#/definitions/ResponseMeta"
type: object
Database:
description: A Database provisioned and owned by a Tenant
properties:
Active:
description: Is this database active?
type: boolean
ClusterID:
description:
The ID of the Cluster in which this database is deployed
type: string
CreatedByID:
description: Created By
type: string
CreatedDate:
description: Created Date
type: string
DSN:
description: Database connection string
type: string
DatabaseName:
description: The name of the physical database in the cluster
type: string
ID:
description: Record Id
type: string
LastModifiedByID:
description: Last Modified By
type: string
LastModifiedDate:
description: Last Modifed Date
type: string
Status:
description: The current status of this Tenant
type: string
TenantID:
description: The ID of the tenant who owns this Database
type: string
Type:
description: "The type of Database (mysql, etc)"
type: string
type: object
DatabaseRequest:
description: An array of Database objects
properties:
Data:
items:
$ref: "#/definitions/Database"
type: array
type: object
DatabaseResponse:
description: An array of Database objects
properties:
Data:
items:
$ref: "#/definitions/Database"
type: array
Meta:
$ref: "#/definitions/ResponseMeta"
type: object
DeleteResponse:
properties:
Data:
items:
$ref: "#/definitions/Message"
type: array
Meta:
$ref: "#/definitions/ResponseMeta"
type: object
Error:
properties:
code:
format: int64
type: integer
fields:
type: string
message:
type: string
type: object
Message:
properties:
Message:
type: string
Ref:
type: string
Status:
type: integer
type: object
Pagination:
properties:
Limit:
format: int64
type: integer
POffset:
format: int64
type: integer
PageSize:
format: int64
type: integer
SetSize:
format: int64
type: integer
type: object
RequestMeta:
properties:
2021-08-05 19:37:53 +00:00
TaxnexusAccount:
description: Taxnexus Account Number of the Reseller or OEM
2021-07-31 03:05:02 +00:00
type: string
required:
2021-08-05 19:37:53 +00:00
- TaxnexusAccount
2021-07-31 03:05:02 +00:00
type: object
ResponseMeta:
properties:
Contact:
description: Microservice Contact Info
type: string
Copyright:
description: Copyright Info
type: string
License:
description: License Information and Restrictions
type: string
OperationID:
description: Operation ID
type: string
Pagination:
$ref: "#/definitions/Pagination"
RequestIP:
description: Request IP Address
type: string
RequestType:
description: Request Type
type: string
RequestURL:
description: Request URL
type: string
ServerInfo:
description: Data Server Info
type: string
ServerResponseTime:
description: Data Server Response Time (ms)
type: string
ServerTimestamp:
description: Backend Server Timestamp
type: string
2021-08-05 19:37:53 +00:00
TaxnexusAccount:
2021-07-31 03:05:02 +00:00
description:
2021-08-05 19:37:53 +00:00
Taxnexus Account Number used for recording transactions
2021-07-31 03:05:02 +00:00
type: string
type: object
Role:
description: A functional role within a Tenant
properties:
Auth0RoleID:
description: The corresponding Auth0 Role
type: string
CreatedByID:
description: Created By
type: string
CreatedDate:
description: Created Date
type: string
Description:
description: Role Description
type: string
ID:
description: Record Id
type: string
LastModifiedByID:
description: Last Modified By
type: string
LastModifiedDate:
description: Last Modifed Date
type: string
RoleName:
description: The name of this role
type: string
TenantID:
description: The ID of the Tenant that owns this Role
type: string
type: object
RoleRequest:
description: An array of Role objects
properties:
Date:
items:
$ref: "#/definitions/Role"
type: array
type: object
RoleResponse:
description: An array of Role objects
properties:
Data:
items:
$ref: "#/definitions/Role"
type: array
Meta:
$ref: "#/definitions/ResponseMeta"
type: object
Template:
properties:
CompanyID:
description: Company
type: string
CreatedByID:
type: string
CreatedDate:
type: string
Description:
description: Description
type: string
HTML:
description: HTML Body
format: byte
type: string
ID:
2021-08-05 19:37:53 +00:00
description: Taxnexus Record Id
2021-07-31 03:05:02 +00:00
type: string
IsActive:
description: Active?
type: boolean
IsMaster:
description: Master Template?
type: boolean
LastModifiedByID:
type: string
LastModifiedDate:
type: string
Name:
description: Template Name
type: string
ObjectType:
description: Object
type: string
RecordTypeName:
description: Record Type Name
type: string
TenantID:
description: Tenant that owns this object instance
type: string
Type:
description: Type
type: string
URL:
description: URL
type: string
type: object
TemplateRequest:
description: An array of Templates
properties:
Data:
items:
$ref: "#/definitions/Template"
type: array
type: object
TemplateResponse:
description: An array of Templates
properties:
Data:
items:
$ref: "#/definitions/Template"
type: array
Meta:
$ref: "#/definitions/ResponseMeta"
type: object
Tenant:
2021-08-05 19:37:53 +00:00
description: Taxnexus Account Tenant
2021-07-31 03:05:02 +00:00
properties:
AccountID:
description: The Account that owns this Tenant
type: string
Active:
description: Is this Tenant currently active?
type: boolean
CreatedByID:
description: Created By
type: string
CreatedDate:
description: Created Date
type: string
Databases:
items:
$ref: "#/definitions/Database"
type: array
ID:
description: Record Id
type: string
LastModifiedByID:
description: Last Modified By
type: string
LastModifiedDate:
description: Last Modifed Date
type: string
Roles:
items:
$ref: "#/definitions/Role"
type: array
Status:
description: The current status of this Tenant
type: string
TenantName:
description: Name of the Tenant Resource
type: string
TenantUsers:
items:
$ref: "#/definitions/TenantUser"
type: array
Type:
description: The type of Tenant
type: string
Version:
description:
The version number of the Tenant Onboarding system used to
create this tenant
type: string
type: object
TenantRequest:
description: An array of Tenant objects
properties:
Data:
items:
$ref: "#/definitions/Tenant"
type: array
type: object
TenantResponse:
description: An array of Tenant objects
properties:
Data:
items:
$ref: "#/definitions/Tenant"
type: array
Meta:
$ref: "#/definitions/ResponseMeta"
type: object
TenantUser:
description: Relationship object that connects users to a tenant
properties:
AccessLevel:
description: The makeTenantUser access level for this User
type: string
AccountID:
description: Account ID
type: string
Auth0UserID:
description: Auth0 User ID
type: string
CompanyName:
description: Account Name
type: string
ContactID:
description: Contact ID
type: string
2021-08-05 19:37:53 +00:00
TaxnexusAccount:
description: Taxnexus Account
2021-07-31 03:05:02 +00:00
type: string
TenantActive:
description: Tenant active?
type: boolean
TenantID:
description: The Tenant ID
type: string
TenantName:
description: Tenant Name
type: string
TenantStatus:
description: Tenant Status
type: string
TenantType:
description: Tenant type
type: string
TenantVersion:
description: Tenant Version
type: string
UserEmail:
description: User Email Address
type: string
UserFullName:
description: User Full Name
type: string
UserID:
description: The User ID
type: string
Username:
description: Username
type: string
type: object
User:
properties:
APIKey:
description: API Key
type: string
AboutMe:
description: About Me
type: string
AccountID:
description: Account ID
type: string
Address:
$ref: "#/definitions/Address"
Alias:
description: Alias
type: string
Auth0UserID:
description: Auth0 User Id
type: string
CommunityNickname:
description: Nickname
type: string
CompanyName:
description: Company Name
type: string
ContactID:
description: Contact
type: string
CreatedByID:
description: Created User ID
type: string
CreatedDate:
description: Date Created
type: string
DelegatedApproverID:
description: Delegated Approver
type: string
Department:
description: Department
type: string
Division:
description: Division
type: string
Email:
description: Email address
type: string
EmployeeNumber:
description: Employee Number
type: string
EndOfDay:
description: Time day ends
type: string
Environment:
description: Environment
type: string
Extension:
description: Extension
type: string
FabricAPIKey:
description: Fabric API Key
type: string
Fax:
description: Fax
type: string
FirstName:
description: The first name
type: string
ForecastEnabled:
description: Allow Forecasting
type: boolean
FullPhotoURL:
description: Full Photo URL
type: string
ID:
2021-08-05 19:37:53 +00:00
description: Taxnexus ID
2021-07-31 03:05:02 +00:00
type: string
IsActive:
description: Active
type: boolean
IsPortalEnabled:
description: Is the user enabled for Communities?
type: boolean
IsProphilePhotoActive:
description: Has Profile Photo
type: boolean
IsSystemControlled:
type: boolean
LastIP:
description: IP address of last login
type: string
LastLogin:
description: Last login time
type: string
LastModifiedByID:
description: Last Modified User ID
type: string
LastModifiedDate:
description: Last Modified Date
type: string
LastName:
description: The Last Name
type: string
LoginCount:
description: Number of times user has logged in
format: int64
type: number
ManagerID:
description: Manager
type: string
MobilePhone:
description: Mobile
type: string
Name:
description: Name
type: string
OutOfOfficeMessage:
description: Out of office message
type: string
Phone:
description: Phone
type: string
PortalRole:
description: Portal Role Level
type: string
ProfileID:
description: Profile
type: string
ReceivesAdminEmails:
description: Info Emails
type: boolean
ReceivesAdminInfoEmails:
description: Admin Info Emails
type: boolean
SenderEmail:
description: Email Sender Address
type: string
SenderName:
description: Email Sender Name
type: string
Signature:
description: Email Signature
type: string
SmallPhotoURL:
description: Small Photo URL
type: string
StartOfDay:
description: The time day starts
type: string
2021-08-05 19:37:53 +00:00
TaxnexusAccount:
description: Taxnexus Account
2021-07-31 03:05:02 +00:00
type: string
TenantID:
description: Tenant ID associated with this user
type: string
TenantUsers:
items:
$ref: "#/definitions/TenantUser"
type: array
TimeZone:
description: Time Zone
type: string
Title:
description: Title
type: string
UserRoleID:
description: Role
type: string
UserRoles:
items:
$ref: "#/definitions/UserRole"
type: array
UserType:
description: User Type
type: string
Username:
description: Username
type: string
type: object
UserRequest:
properties:
Data:
items:
$ref: "#/definitions/User"
type: array
type: object
UserResponse:
description: An array of Print-Ready ingest Objects
properties:
Data:
items:
$ref: "#/definitions/User"
type: array
Meta:
$ref: "#/definitions/ResponseMeta"
type: object
UserRole:
description: Relationship object that connects user to a role
properties:
AccountID:
description: Account Id
type: string
Auth0RoleID:
description: Linked role ID
type: string
Auth0UserID:
description: Auth0 User ID
type: string
CompanyName:
description: Company Name
type: string
ContactID:
description: Contact ID
type: string
RoleDescription:
description: Role description
type: string
RoleID:
description: The Role ID
type: string
RoleName:
description: Role Name
type: string
2021-08-05 19:37:53 +00:00
TaxnexusAccount:
description: Taxnexus Account Number
2021-07-31 03:05:02 +00:00
type: string
UserEmail:
description: User Email Address
type: string
UserFullName:
description: User Full Name
type: string
UserID:
description: The User ID
type: string
Username:
description: Username
type: string
type: object