openapi: 3.1.0
info:
version: 16.10.0
title: Amplify Platform API v1.0.0 aca usage API
description: 'The Amplify Platform API provides the interface to perform the following:
- Manage account settings and credentials
- Manage organization settings, users, service accounts, and teams
- Retrieve organization usage data
- Register and manage applications
- Retrieve application metrics and analytics
- Retrieve user, organization, and application activity
See the Amplify Guide for documentation and examples on how to authorize API calls to platform services.
For general documentation refer to the Amplify Platform documentation.
© Axway 2026. All rights reserved.'
contact:
email: support@axway.com
termsOfService: https://www.axway.com/en/axway-platform-terms-of-use
servers:
- url: https://platform.axway.com/api/v1
tags:
- name: usage
paths:
/usage/automatic:
parameters: []
post:
summary: Axway Uploads an Automatic Usage Report
description: "Uploads an automatic usage report for org\n\n___Auth Requirement___\n - _One of_\n - Support access.\n - `administrator`, `api_central_admin`, or `usage_reporter` access to the organization.\n"
externalDocs:
description: Usage Reporting Documentation
url: https://docs.axway.com/csh?context=222126025
tags:
- usage
operationId: usage_uploadAutomatic
x-max-content-length: 512000
x-publishes:
- platform.usage.report
responses:
'202':
description: Accepted
'400':
description: Bad Request
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
examples:
MAX_FILE_SIZE:
value:
success: false
description: The file exceeds the maximum upload size of %d bytes.
code: 400
PARAM_INVALID:
value:
$ref: '#/components/examples/PARAM_INVALID/value'
PARAM_INVALID_REASON:
value:
success: false
description: '"%s" contained an invalid value: errors.reasons.undefined.'
code: 400
internalCode: 747
USAGE_EVENT_COUNT:
value:
success: false
description: Usage report file must contain no greater than %d entries.
code: 400
FILE_INVALID_TYPE:
value:
success: false
description: '"file" contained an invalid value: Not a valid json file.'
code: 400
internalCode: 747
FILE_POSSIBLE_XSS:
value:
success: false
description: '"file" contained an invalid value: Possible XSS data in the file content.'
code: 400
internalCode: 747
USAGE_INVALID_DATE:
value:
success: false
description: '"file.report" contained an invalid value: Invalid date in `report` keys.'
code: 400
internalCode: 747
USAGE_META_TYPE:
value:
success: false
description: '"%s" contained an invalid value: Type "%s" is not supported for the field "%s".'
code: 400
internalCode: 747
USAGE_NO_METRICS:
value:
success: false
description: '"file" contained an invalid value: `report` did not include any valid metrics.'
code: 400
internalCode: 747
FILE_MISSING:
value:
success: false
description: '"file" contained an invalid value: No file attached.'
code: 400
internalCode: 747
FILE_MULTIPLE:
value:
success: false
description: '"file" contained an invalid value: Multiple files attached.'
code: 400
internalCode: 747
FILE_INVALID_MIMETYPE:
value:
success: false
description: '"file" contained an invalid value: File type should be application/json.'
code: 400
internalCode: 747
FILE_EMPTY:
value:
success: false
description: '"file" contained an invalid value: Empty files not allowed.'
code: 400
internalCode: 747
FILE_INVALID_EXTENSION:
value:
success: false
description: '"file" contained an invalid value: The file extension %s is not allowed.'
code: 400
internalCode: 747
FILE_NAME_TOO_LONG:
value:
success: false
description: '"file" contained an invalid value: The provided file name too long. Maximum allowed file name length is %d symbols.'
code: 400
internalCode: 747
FILE_INVALID_FILENAME:
value:
success: false
description: '"file" contained an invalid value: Invalid symbols in the file name.'
code: 400
internalCode: 747
FILE_MISSING_FIELDS:
value:
success: false
description: '"file" contained an invalid value: Content is missing the required fields: [ %s ].'
code: 400
internalCode: 747
FILE_INVALID_DATA_TYPE:
value:
success: false
description: '"file" contained an invalid value: Metrics data type invalid for %s: entitlement type %s.'
code: 400
internalCode: 747
FORBIDDEN:
value:
$ref: '#/components/examples/FORBIDDEN/value'
LOGIN_REQUIRED:
value:
$ref: '#/components/examples/LOGIN_REQUIRED/value'
NOT_FOUND:
value:
$ref: '#/components/examples/NOT_FOUND/value'
IDP_REQUIRED:
value:
$ref: '#/components/examples/IDP_REQUIRED/value'
USER_NOT_ADMIN:
value:
$ref: '#/components/examples/USER_NOT_ADMIN/value'
PARAM_REQUIRED:
value:
$ref: '#/components/examples/PARAM_REQUIRED/value'
security:
- SessionCookie: []
- BearerUser: []
- BearerClient: []
requestBody:
content:
multipart/form-data:
schema:
properties:
file:
type: string
description: The usage report file. Max file size is 500 KiB or 4000 reported metrics.
format: binary
organizationId:
type: string
description: Optional guid of an org to upload usage for.
uploadMethod:
type: string
description: Method for usage report upload or entry. Forbidden for automatic reporting.
enum:
- automatic
- manual
- entry
default: automatic
userId:
type: string
description: Optional user guid for user uploading usage. Defaults to signed-in user.
required:
- file
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
/usage:
parameters: []
get:
summary: Axway Fetches Usage Reports
description: "Fetches usage reports for an org\n\n___Auth Requirement___\n - _One of_\n - Support access.\n - `administrator`, `auditor`, or `usage_reporter` access to the organization.\n"
tags:
- usage
operationId: usage_find
responses:
'200':
description: Response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/Response'
- properties:
result:
$ref: '#/components/schemas/UsageEntryList'
- properties:
metadata:
$ref: '#/components/schemas/ResponseMetadata'
examples:
UsageFind200Example:
summary: Default usage_find 200 response
x-microcks-default: true
value: example_value
'400':
description: Bad Request
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
examples:
DATE_RANGE_INVALID:
value:
success: false
description: startDate must be before endDate
code: 400
FORBIDDEN:
value:
$ref: '#/components/examples/FORBIDDEN/value'
LOGIN_REQUIRED:
value:
$ref: '#/components/examples/LOGIN_REQUIRED/value'
NOT_FOUND:
value:
$ref: '#/components/examples/NOT_FOUND/value'
IDP_REQUIRED:
value:
$ref: '#/components/examples/IDP_REQUIRED/value'
USER_NOT_ADMIN:
value:
$ref: '#/components/examples/USER_NOT_ADMIN/value'
PARAM_INVALID:
value:
$ref: '#/components/examples/PARAM_INVALID/value'
security:
- SessionCookie: []
- BearerUser: []
- BearerClient: []
parameters:
- $ref: '#/components/parameters/fields'
example: example_value
- $ref: '#/components/parameters/exclude_fields'
example: example_value
- in: query
name: endDate
required: false
schema:
type: number
description: End of the reporting range; defaults to current time.
example: 1.0
- in: query
name: env_guid
required: false
schema:
type: string
description: Environment id
default: null
example: example_value
- in: query
name: org_id
required: false
schema:
type: string
description: Optional id of an org to find usage reports for. Defaults to finding for the session org.
example: 507f1f77bcf86cd799439011
- in: query
name: received
required: false
schema:
type: boolean
description: Whether to query usage uploads based on date received instead of reported period
default: false
example: true
- in: query
name: startDate
required: false
schema:
type: number
description: Start of the reporting range; defaults to last 24 hours.
example: 1.0
- in: query
name: status
required: false
schema:
type: string
description: Status
enum:
- VALIDATING
- VALIDATED
- PROCESSED
- INVALIDATED
- PARTIALLY_ACCEPTED
- MISSING_EVENTS
- INVALID_METRICS
- ENRICHMENT_ERROR
- ANALYTICS_UPLOAD_FAILED
- ANALYTICS_MISSMATCH
- ANALYTICS_ERROR
- INVALID_ENVIRONMENT
- MISSING_FILE
default: null
example: VALIDATING
- in: query
name: uploadMethod
required: false
schema:
type: string
description: Upload method to filter reports by.
enum:
- automatic
- manual
- entry
example: automatic
- in: query
name: limit
required: false
schema:
type: number
minimum: 0
maximum: 100
description: Number of results per page. Zero will return an empty result, but the matched count in meta will be returned.
default: 10
example: 1.0
- in: query
name: page
required: false
schema:
type: number
description: Page of results.
default: 1
example: 1.0
- in: query
name: skip
required: false
schema:
type: number
description: Number of items to skip in results, used for pagination.
default: 0
example: 1.0
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
post:
summary: Axway Uploads a Usage Report
description: "Uploads usage report for org\n\n___Auth Requirement___\n - _One of_\n - Support access.\n - `administrator`, `api_central_admin`, or `usage_reporter` access to the organization.\n"
externalDocs:
description: Usage Reporting Documentation
url: https://docs.axway.com/csh?context=222126025
tags:
- usage
operationId: usage_upload
x-max-content-length: 512000
x-publishes:
- platform.usage.report
responses:
'202':
description: Accepted
'400':
description: Bad Request
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
examples:
MAX_FILE_SIZE:
value:
success: false
description: The file exceeds the maximum upload size of %d bytes.
code: 400
PARAM_INVALID:
value:
$ref: '#/components/examples/PARAM_INVALID/value'
PARAM_INVALID_REASON:
value:
success: false
description: '"%s" contained an invalid value: errors.reasons.undefined.'
code: 400
internalCode: 747
USAGE_EVENT_COUNT:
value:
success: false
description: Usage report file must contain no greater than %d entries.
code: 400
FILE_INVALID_TYPE:
value:
success: false
description: '"file" contained an invalid value: Not a valid json file.'
code: 400
internalCode: 747
FILE_POSSIBLE_XSS:
value:
success: false
description: '"file" contained an invalid value: Possible XSS data in the file content.'
code: 400
internalCode: 747
USAGE_INVALID_DATE:
value:
success: false
description: '"file.report" contained an invalid value: Invalid date in `report` keys.'
code: 400
internalCode: 747
USAGE_META_TYPE:
value:
success: false
description: '"%s" contained an invalid value: Type "%s" is not supported for the field "%s".'
code: 400
internalCode: 747
USAGE_NO_METRICS:
value:
success: false
description: '"file" contained an invalid value: `report` did not include any valid metrics.'
code: 400
internalCode: 747
FILE_MISSING:
value:
success: false
description: '"file" contained an invalid value: No file attached.'
code: 400
internalCode: 747
FILE_MULTIPLE:
value:
success: false
description: '"file" contained an invalid value: Multiple files attached.'
code: 400
internalCode: 747
FILE_INVALID_MIMETYPE:
value:
success: false
description: '"file" contained an invalid value: File type should be application/json.'
code: 400
internalCode: 747
FILE_EMPTY:
value:
success: false
description: '"file" contained an invalid value: Empty files not allowed.'
code: 400
internalCode: 747
FILE_INVALID_EXTENSION:
value:
success: false
description: '"file" contained an invalid value: The file extension %s is not allowed.'
code: 400
internalCode: 747
FILE_NAME_TOO_LONG:
value:
success: false
description: '"file" contained an invalid value: The provided file name too long. Maximum allowed file name length is %d symbols.'
code: 400
internalCode: 747
FILE_INVALID_FILENAME:
value:
success: false
description: '"file" contained an invalid value: Invalid symbols in the file name.'
code: 400
internalCode: 747
FILE_MISSING_FIELDS:
value:
success: false
description: '"file" contained an invalid value: Content is missing the required fields: [ %s ].'
code: 400
internalCode: 747
FILE_INVALID_DATA_TYPE:
value:
success: false
description: '"file" contained an invalid value: Metrics data type invalid for %s: entitlement type %s.'
code: 400
internalCode: 747
FORBIDDEN:
value:
$ref: '#/components/examples/FORBIDDEN/value'
LOGIN_REQUIRED:
value:
$ref: '#/components/examples/LOGIN_REQUIRED/value'
NOT_FOUND:
value:
$ref: '#/components/examples/NOT_FOUND/value'
IDP_REQUIRED:
value:
$ref: '#/components/examples/IDP_REQUIRED/value'
USER_NOT_ADMIN:
value:
$ref: '#/components/examples/USER_NOT_ADMIN/value'
PARAM_REQUIRED:
value:
$ref: '#/components/examples/PARAM_REQUIRED/value'
security:
- SessionCookie: []
- BearerUser: []
- BearerClient: []
requestBody:
content:
multipart/form-data:
schema:
properties:
file:
type: string
description: The usage report file. Max file size is 500 KiB or 4000 reported metrics.
format: binary
organizationId:
type: string
description: Optional guid of an org to upload usage for.
uploadMethod:
type: string
description: Method for usage report upload or entry. Forbidden for automatic reporting.
enum:
- automatic
- manual
- entry
default: automatic
userId:
type: string
description: Optional user guid for user uploading usage. Defaults to signed-in user.
required:
- file
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
/usage/{file_id}:
parameters: []
get:
summary: Axway Downloads a Usage Report
description: 'Returns a download of a usage report for the org
___Auth Requirement___
Requires support role or `administrator` or `usage_reporter` role in the organization the usage report is associated to.'
tags:
- usage
operationId: usage_download
responses:
'200':
description: Success
content:
application/octet-stream:
schema:
type: string
format: binary
description: Report file in JSON format.
'400':
description: Bad Request
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
examples:
FORBIDDEN:
value:
$ref: '#/components/examples/FORBIDDEN/value'
NOT_FOUND:
value:
$ref: '#/components/examples/NOT_FOUND/value'
LOGIN_REQUIRED:
value:
$ref: '#/components/examples/LOGIN_REQUIRED/value'
PARAM_INVALID:
value:
$ref: '#/components/examples/PARAM_INVALID/value'
PARAM_REQUIRED:
value:
$ref: '#/components/examples/PARAM_REQUIRED/value'
security:
- SessionCookie: []
- BearerUser: []
parameters:
- in: path
name: file_id
required: true
schema:
type: string
description: The file_id of the usage report.
example: 507f1f77bcf86cd799439011
- in: query
name: org_guid
required: true
schema:
type: string
description: Guid of the organization owning the report
example: example_value
- in: query
name: timestamp
required: true
schema:
type: integer
description: Timestamp when report is created
example: 1714000000000
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
/org/{org_id}/usage:
parameters: []
get:
summary: Axway Organization Usage
description: "Returns usage information about an organization\n\n___Auth Requirement___\n - _One of_\n - `administrator`, `auditor`, `developer`, or `usage_reporter` access to the organization. Developer access may be restricted by the organization usage access control setting.\n - Auth token.\n"
tags:
- usage
operationId: org_findUsage
responses:
'200':
description: Response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/Response'
- properties:
result:
properties:
ending:
type: string
format: date-time
description: Date/time the usage is calculated to.
basis:
type: string
enum:
- range
- EOD
- EOM
- end_date
description: Basis for the time range the data is calculated to.
org_id:
type: integer
description: The org_id of the organization.
created:
type: string
format: date-time
description: Date/time the organization was created.
from:
type: string
format: date-time
description: Date/time the usage is calculated from.
to:
type: string
format: date-time
description: Date/time the usage is calculated to.
from_ts:
type: integer
format: date-time
description: Timestamp the usage is calculated from.
to_ts:
type: integer
format: date-time
description: Timestamp the usage is calculated to.
usage:
type: object
description: Amount of usage for the org over the time range
properties: {}
additionalProperties: true
examples:
OrgFindusage200Example:
summary: Default org_findUsage 200 response
x-microcks-default: true
value: example_value
'400':
description: Bad Request
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
examples:
NOT_FOUND:
value:
$ref: '#/components/examples/NOT_FOUND/value'
FORBIDDEN:
value:
$ref: '#/components/examples/FORBIDDEN/value'
IDP_REQUIRED:
value:
$ref: '#/components/examples/IDP_REQUIRED/value'
USER_NOT_ADMIN:
value:
$ref: '#/components/examples/USER_NOT_ADMIN/value'
LOGIN_REQUIRED:
value:
$ref: '#/components/examples/LOGIN_REQUIRED/value'
PARAM_INVALID:
value:
$ref: '#/components/examples/PARAM_INVALID/value'
PARAM_REQUIRED:
value:
$ref: '#/components/examples/PARAM_REQUIRED/value'
security:
- BearerClient: []
- SessionCookie: []
- BearerUser: []
- AuthToken: []
parameters:
- $ref: '#/components/parameters/fields'
example: example_value
- $ref: '#/components/parameters/exclude_fields'
example: example_value
- in: path
name: org_id
required: true
schema:
type: string
description: The `guid` or `org_id` of the organization to get usage for.
example: 507f1f77bcf86cd799439011
- in: query
name: entitlement
required: false
schema:
type: string
description: Single entitlement to get annual usage for
example: example_value
- in: query
name: from
required: false
schema:
type: string
description: Period starting timestamp
example: example_value
- in: query
name: month
required: false
schema:
type: number
description: Period ending in provided month to get usage for (optional, default is current month)
example: 1.0
- in: query
name: skipcache
required: false
schema:
type: boolean
description: Forces cache refresh
example: true
- in: query
name: to
required: false
schema:
type: string
description: Period ending timestamp
example: example_value
- in: query
name: year
required: false
schema:
type: number
description: Period ending in provided year to get usage for (optional, default is current year)
example: 1.0
- in: header
name: x-auth-token
required: false
schema:
type: string
description: Token to authorize the request.
example: eyJhbGciOiJIUzI1NiJ9.example
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
components:
schemas:
Response:
type: object
properties:
success:
type: boolean
description: Whether the request was successful.
example: true
UsageEntryList:
title: UsageEntryList
type: array
description: A list of UsageEntry objects.
items:
$ref: '#/components/schemas/UsageEntry'
Error:
type: object
allOf:
- $ref: '#/components/schemas/Response'
- type: object
properties:
code:
type: number
description: HTTP status code.
description:
type: string
description: A message describing the error.
internalCode:
type: number
description: Internal code.
ResponseMetadata:
type: object
properties:
count:
type: number
description: Number of results included in the response.
example: 1.0
limit:
type: number
description: Number of results per page.
example: 1.0
matched:
type: number
description: Total number of matched results.
example: 1.0
page:
type: number
description: Page of results.
example: 1.0
pages:
type: number
description: Total number of pages of results.
example: 1.0
skip:
type: number
description: Number of results skipped in pagination.
example: 1.0
UsageEntry:
type: object
properties:
created:
type: string
format: date-time
description: Date and time when report was created.
example: '2026-04-21T00:00:00Z'
created_by:
type: object
description: Details of the user that created the organization.
required:
- guid
- type
properties:
client_id:
type: string
description: The client_id of the client that created the organization.
email:
type: string
format: email
description: Email address of the user that created the organization.
guid:
type: string
description: '`guid` of the creator.'
name:
type: string
description: The name of the user or client that created the organization.
type:
type: string
description: Type of the creator.
enum:
- user
- client
example:
client_id: 507f1f77bcf86cd799439011
email: user@example.com
guid: example_value
name: Example Name
type: user
downloadable:
type: boolean
description: Indicates if the report file is available for download.
example: true
endDate:
type: string
format: date-time
description: End of the reporting range.
example: '2026-04-21T00:00:00Z'
envId:
type: string
format: uuid
description: '`guid` of the environment the report is for.'
example: example_value
fileId:
type: string
description: Identifier of report entry file.
example: example_value
governance:
type: string
description: Governance of the environment this report is for.
enum:
- Customer Managed
- Axway Managed
example: Customer Managed
name:
type: string
description: Name of the report entry file.
example: Example Name
organizationId:
type: string
format: uuid
description: '`guid` of the organization the report is for.'
example: example_value
startDate:
type: string
format: date-time
description: Start of the reporting range.
example: '2026-04-21T00:00:00Z'
status:
type: string
description: Status of the report.
enum:
- PROCESSED
example: PROCESSED
unrecognized:
type: array
description: List of unrecognized metrics for reports with status `INVALID_METRIC`.
items:
type: string
example:
- example_value
uploadMethod:
type: string
description: Upload method.
enum:
- automatic
- manual
example: automatic
parameters:
exclude_fields:
name: exclude_fields
in: query
description: A list of fields to exclude from the response.
schema:
type: array
items:
type: string
fields:
name: fields
in: query
description: A list of fields to include in the response.
schema:
type: array
items:
type: string
examples:
IDP_REQUIRED:
value:
success: false
description: You must sign in using the Identity Provider configured by your organization's administrators to access this organization.
code: 401
internalCode: 235
USER_NOT_ADMIN:
value:
success: false
description: You are not authorized to perform this action. Please contact your organization administrator.
code: 403
PARAM_INVALID:
value:
success: false
description: '"%s" contained an invalid value.'
code: 400
internalCode: 74
NOT_FOUND:
value:
success: false
description: Resource Not Found
code: 404
FORBIDDEN:
value:
success: false
description: You do not have access privileges to view this content.
code: 403
PARAM_REQUIRED:
value:
success: false
description: '"%s" is a required parameter.'
code: 400
internalCode: 77
LOGIN_REQUIRED:
value:
success: false
description: Sign-in Required
code: 401
securitySchemes:
AuthToken:
description: Auth token for internal services
type: apiKey
in: header
name: x-auth-token
BearerClient:
description: Service account access token
type: http
scheme: bearer
bearerFormat: jwt
BearerService:
description: Service account access token for an internal client
type: http
scheme: bearer
bearerFormat: jwt
BearerUser:
description: AxwayID user session access token
type: http
scheme: bearer
bearerFormat: jwt
MFA:
description: Multi-factor authentication code
type: apiKey
in: header
name: x-auth-code
OAuth2:
type: oauth2
flows:
clientCredentials:
tokenUrl: https://login.axway.com/auth/realms/Broker/protocol/openid-connect/token
scopes: {}
authorizationCode:
authorizationUrl: https://login.axway.com/auth/realms/Broker/openid-connect/auth
tokenUrl: https://login.axway.com/auth/realms/Broker/openid-connect/token
scopes: {}
implicit:
authorizationUrl: https://login.axway.com/auth/realms/Broker/openid-connect/auth
scopes: {}
Password:
description: User password
type: apiKey
in: header
name: x-auth-password
SessionCookie:
description: Platform session cookie
type: apiKey
in: cookie
name: connect.sid