Skip to main content

Auvious Auth Server API v2.1.6

Auvious Auth Server provides the core security related services.

info

You are viewing REST API documentation. This documentation is auto-generated from a swagger specification which itself is generated from annotations in the source code of the project. It is possible that this documentation includes bugs and that code samples are incomplete or wrong.

Authentication

  • HTTP Authentication, scheme: bearer
  • OAuth 2.0 Authorization.
    • Flow: clientCredentials

    • OAuth 2.0 Token URL = /oauth/token

    • OAuth 2.0 Scope

      ScopeScope Description

Tickets

Get a ticket.

GET https://auvious.video/api/ticket/{ticketId} HTTP/1.1
Host: auvious.video
Accept: */*

Get a ticket. Regular access tickets return the persisted ticket response. Appointments manage tickets return the same response shape with properties filtered to properties.appointment_id and properties.application_id. Lifecycle timestamp fields include disabled, revoked, and rotated; expired remains a derived boolean.

Parameters

ParameterInTypeRequiredDescription
ticketIdpathstringtruenone

Responses

Overview
StatusMeaningDescriptionSchema
200OKOKTicket
Examples

200 Response

caution

To perform this operation, you must be authenticated by means of one of the following methods: BearerToken, OAuth2ClientCredentials

Code samples

curl -X GET https://auvious.video/api/ticket/{ticketId} \
-H 'Accept: */*' \ -H 'Authorization: Bearer {access-token}'

Update a ticket

PUT https://auvious.video/api/ticket/{ticketId} HTTP/1.1
Host: auvious.video
Content-Type: application/json
Accept: */*

Update a ticket with new properties. The ticket will be modified according to the provided properties.

Request body

{
"organizationId": "string",
"properties": {
"property1": {},
"property2": {}
}
}

Parameters

ParameterInTypeRequiredDescription
ticketIdpathstringtruenone
bodybodyUpdateTicketWebCommandtruenone

Responses

Overview
StatusMeaningDescriptionSchema
200OKOKTicket
Examples

200 Response

caution

To perform this operation, you must be authenticated by means of one of the following methods: BearerToken, OAuth2ClientCredentials

Code samples

curl -X PUT https://auvious.video/api/ticket/{ticketId} \
-H 'Content-Type: application/json' \ -H 'Accept: */*' \ -H 'Authorization: Bearer {access-token}'

Delete a ticket.

DELETE https://auvious.video/api/ticket/{ticketId} HTTP/1.1
Host: auvious.video

Delete a ticket. Optional operation, use it to delete a token early, before it's used or expired

Parameters

ParameterInTypeRequiredDescription
ticketIdpathstringtruenone

Responses

Overview
StatusMeaningDescriptionSchema
200OKOKNone
caution

To perform this operation, you must be authenticated by means of one of the following methods: BearerToken, OAuth2ClientCredentials

Code samples

curl -X DELETE https://auvious.video/api/ticket/{ticketId} \
-H 'Authorization: Bearer {access-token}'

Rotate a ticket

POST https://auvious.video/api/ticket/{ticketId}/rotate HTTP/1.1
Host: auvious.video
Content-Type: application/json
Accept: */*

Rotate a ticket and return its replacement. The replacement inherits stable ticket identity from the original, applies policy-allowed replacement properties, and uses either expiresAt or properties.ttl for generic validity. Service-only rotate responses return the full persisted successor ticket; public manage lookup returns a sanitized view.

Request body

{
"organizationId": "string",
"expiresAt": "2019-08-24T14:15:22Z",
"properties": {
"property1": {},
"property2": {}
}
}

Parameters

ParameterInTypeRequiredDescription
ticketIdpathstringtruenone
bodybodyRotateTicketWebCommandtruenone

Responses

Overview
StatusMeaningDescriptionSchema
200OKOKTicket
400Bad RequestBad RequestTicket
401UnauthorizedUnauthorizedTicket
403ForbiddenForbiddenTicket
404Not FoundNot FoundTicket
409ConflictConflictTicket
Examples

200 Response

caution

To perform this operation, you must be authenticated by means of one of the following methods: BearerToken, OAuth2ClientCredentials

Code samples

curl -X POST https://auvious.video/api/ticket/{ticketId}/rotate \
-H 'Content-Type: application/json' \ -H 'Accept: */*' \ -H 'Authorization: Bearer {access-token}'

Revoke a ticket

POST https://auvious.video/api/ticket/{ticketId}/revoke HTTP/1.1
Host: auvious.video
Content-Type: application/json

Revoke a ticket. If someone tries to use this ticket he will get 'error_description'='REVOKED'

Request body

{
"organizationId": "string"
}

Parameters

ParameterInTypeRequiredDescription
ticketIdpathstringtruenone
bodybodyRevokeTicketWebCommandfalsenone

Responses

Overview
StatusMeaningDescriptionSchema
204No ContentNo ContentNone
caution

To perform this operation, you must be authenticated by means of one of the following methods: BearerToken, OAuth2ClientCredentials

Code samples

curl -X POST https://auvious.video/api/ticket/{ticketId}/revoke \
-H 'Content-Type: application/json' \ -H 'Authorization: Bearer {access-token}'

Enable a ticket

POST https://auvious.video/api/ticket/{ticketId}/enable HTTP/1.1
Host: auvious.video

Enable a ticket.

Parameters

ParameterInTypeRequiredDescription
ticketIdpathstringtruenone

Responses

Overview
StatusMeaningDescriptionSchema
204No ContentNo ContentNone
caution

To perform this operation, you must be authenticated by means of one of the following methods: BearerToken, OAuth2ClientCredentials

Code samples

curl -X POST https://auvious.video/api/ticket/{ticketId}/enable \
-H 'Authorization: Bearer {access-token}'

Disable a ticket

POST https://auvious.video/api/ticket/{ticketId}/disable HTTP/1.1
Host: auvious.video

Disable a ticket. If someone tries to use this ticket he will get 'error_description'='DISABLED'

Parameters

ParameterInTypeRequiredDescription
ticketIdpathstringtruenone

Responses

Overview
StatusMeaningDescriptionSchema
204No ContentNo ContentNone
caution

To perform this operation, you must be authenticated by means of one of the following methods: BearerToken, OAuth2ClientCredentials

Code samples

curl -X POST https://auvious.video/api/ticket/{ticketId}/disable \
-H 'Authorization: Bearer {access-token}'

Create a ticket

POST https://auvious.video/api/ticket HTTP/1.1
Host: auvious.video
Content-Type: application/json
Accept: */*

Create a new ticket. Supported ticket families include single-use, multi-use, schedule, and appointments-manage tickets; lifecycle and usage semantics vary by type. Service-only create responses return the full persisted ticket, including ticket properties.

Request body

{
"type": "GENESYS_SINGLE_USE_TICKET",
"organizationId": "string",
"properties": {
"property1": {},
"property2": {}
},
"expiresAt": "2019-08-24T14:15:22Z",
"length": 6,
"grouping": true,
"disabled": true,
"mode": "LETTERS_ONLY"
}

Parameters

ParameterInTypeRequiredDescription
bodybodyCreateTicketWebCommandtruenone

Responses

Overview
StatusMeaningDescriptionSchema
200OKOKTicket
Examples

200 Response

caution

To perform this operation, you must be authenticated by means of one of the following methods: BearerToken, OAuth2ClientCredentials

Code samples

curl -X POST https://auvious.video/api/ticket \
-H 'Content-Type: application/json' \ -H 'Accept: */*' \ -H 'Authorization: Bearer {access-token}'

Add to calendar

GET https://auvious.video/api/ticket/{ticketId}/event HTTP/1.1
Host: auvious.video
Accept: text/calendar
X-Forwarded-Proto: https
Host: string

Add to calendar

Parameters

ParameterInTypeRequiredDescription
ticketIdpathstringtruenone
calendarquerystringfalsenone
X-Forwarded-Protoheaderstringfalsenone
Hostheaderstringtruenone

Responses

Overview
StatusMeaningDescriptionSchema
200OKOKstring
Examples

200 Response

caution

To perform this operation, you must be authenticated by means of one of the following methods: BearerToken, OAuth2ClientCredentials

Code samples

curl -X GET https://auvious.video/api/ticket/{ticketId}/event \
-H 'Accept: text/calendar' \ -H 'X-Forwarded-Proto: https' \ -H 'Host: string' \ -H 'Authorization: Bearer {access-token}'

Schemas

UpdateTicketWebCommand

{
"organizationId": "string",
"properties": {
"property1": {},
"property2": {}
}
}

Properties

NameTypeRequiredRestrictionsDescription
organizationIdstringfalsenonenone
propertiesobjecttruenonenone
» additionalPropertiesobjectfalsenonenone

Ticket

{
"id": "string",
"userId": "string",
"organizationId": "string",
"type": "GENESYS_SINGLE_USE_TICKET",
"properties": {
"property1": {},
"property2": {}
},
"disabled": "2019-08-24T14:15:22Z",
"revoked": "2019-08-24T14:15:22Z",
"rotated": "2019-08-24T14:15:22Z",
"createdAt": "2019-08-24T14:15:22Z",
"expiresAt": "2019-08-24T14:15:22Z",
"version": 0,
"expired": true
}

Properties

NameTypeRequiredRestrictionsDescription
idstringfalsenonenone
userIdstringfalsenonenone
organizationIdstringfalsenonenone
typestringfalsenonenone
propertiesobjectfalsenonenone
» additionalPropertiesobjectfalsenonenone
disabledstring(date-time)falsenonenone
revokedstring(date-time)falsenonenone
rotatedstring(date-time)falsenonenone
createdAtstring(date-time)falsenonenone
expiresAtstring(date-time)falsenonenone
versioninteger(int64)falsenonenone
expiredbooleanfalsenonenone
Enumerated Values
PropertyValue
typeGENESYS_SINGLE_USE_TICKET
typeGENESYS_MULTI_USE_TICKET
typeGENESYS_SCHEDULE_TICKET
typeMULTI_USE_TICKET
typeSCHEDULE_TICKET
typeAPPOINTMENTS_SCHEDULE_TICKET
typeAPPOINTMENTS_MANAGE_TICKET
typeSINGLE_USE_TICKET
typeSINGLE_USE_SCHEDULE_TICKET
typeSINGLE_USE_APPOINTMENTS_SCHEDULE_TICKET

RotateTicketWebCommand

{
"organizationId": "string",
"expiresAt": "2019-08-24T14:15:22Z",
"properties": {
"property1": {},
"property2": {}
}
}

Request body for rotating a ticket. The replacement may set a generic expiresAt or properties.ttl validity boundary, and may provide policy-allowed replacement properties.

Properties

NameTypeRequiredRestrictionsDescription
organizationIdstringfalsenoneOrganization that owns the ticket.
expiresAtstring(date-time)falsenoneAbsolute replacement ticket expiration timestamp. Mutually exclusive with properties.ttl.
propertiesobjectfalsenonePolicy-allowed replacement ticket properties. Ticket-type-specific data belongs here; opaque signed values are not interpreted by Auth.
» additionalPropertiesobjectfalsenonePolicy-allowed replacement ticket properties. Ticket-type-specific data belongs here; opaque signed values are not interpreted by Auth.

RevokeTicketWebCommand

{
"organizationId": "string"
}

Properties

NameTypeRequiredRestrictionsDescription
organizationIdstringfalsenonenone

CreateTicketWebCommand

{
"type": "GENESYS_SINGLE_USE_TICKET",
"organizationId": "string",
"properties": {
"property1": {},
"property2": {}
},
"expiresAt": "2019-08-24T14:15:22Z",
"length": 6,
"grouping": true,
"disabled": true,
"mode": "LETTERS_ONLY"
}

Properties

NameTypeRequiredRestrictionsDescription
typestringtruenonenone
organizationIdstringfalsenonenone
propertiesobjecttruenonenone
» additionalPropertiesobjectfalsenonenone
expiresAtstring(date-time)falsenoneAbsolute ticket expiration timestamp. Mutually exclusive with properties.ttl; use this when the caller owns the exact validity boundary.
lengthinteger(int32)falsenonenone
groupingbooleanfalsenonenone
disabledbooleanfalsenonenone
modestringfalsenonenone
Enumerated Values
PropertyValue
typeGENESYS_SINGLE_USE_TICKET
typeGENESYS_MULTI_USE_TICKET
typeGENESYS_SCHEDULE_TICKET
typeMULTI_USE_TICKET
typeSCHEDULE_TICKET
typeAPPOINTMENTS_SCHEDULE_TICKET
typeAPPOINTMENTS_MANAGE_TICKET
typeSINGLE_USE_TICKET
typeSINGLE_USE_SCHEDULE_TICKET
typeSINGLE_USE_APPOINTMENTS_SCHEDULE_TICKET
modeLETTERS_ONLY
modeNUMBERS_ONLY
modeLETTERS_AND_NUMBERS