Create a support ticket

curl --request POST \
  --url https://api.spacebring.com/support/tickets/v1 \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "ticket": {
    "type": "access",
    "text": "<string>",
    "locationRef": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "userRefRequester": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  }
}
'

{
  "activities": [
    {
      "createDate": "2023-11-07T05:31:56Z",
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "membership": {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "roleType": "<string>",
        "type": "<string>",
        "user": {
          "blocked": true,
          "email": "<string>",
          "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "name": "<string>",
          "surname": "<string>",
          "phoneNumber": "<string>",
          "photoUrl": "<string>"
        }
      },
      "ticketRef": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "type": "comment",
      "data": {
        "attachments": [
          {
            "key": "<string>"
          }
        ],
        "text": "<string>",
        "status": "<string>",
        "membershipAssignee": {
          "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "roleType": "<string>",
          "type": "<string>",
          "user": {
            "blocked": true,
            "email": "<string>",
            "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "name": "<string>",
            "surname": "<string>",
            "phoneNumber": "<string>",
            "photoUrl": "<string>"
          }
        },
        "previousAttributes": {
          "status": "<string>",
          "membershipAssignee": {
            "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "roleType": "<string>",
            "type": "<string>",
            "user": {
              "blocked": true,
              "email": "<string>",
              "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
              "name": "<string>",
              "surname": "<string>",
              "phoneNumber": "<string>",
              "photoUrl": "<string>"
            }
          }
        }
      }
    }
  ],
  "ticket": {
    "createDate": "2023-11-07T05:31:56Z",
    "description": "<string>",
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "locationRef": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "membershipAssignee": {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "roleType": "<string>",
      "type": "<string>",
      "user": {
        "blocked": true,
        "email": "<string>",
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "name": "<string>",
        "surname": "<string>",
        "phoneNumber": "<string>",
        "photoUrl": "<string>"
      }
    },
    "membershipRequester": {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "roleType": "<string>",
      "type": "<string>",
      "user": {
        "blocked": true,
        "email": "<string>",
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "name": "<string>",
        "surname": "<string>",
        "phoneNumber": "<string>",
        "photoUrl": "<string>"
      }
    },
    "membershipRefAssignee": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "membershipRefRequester": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "number": 123,
    "status": "new",
    "type": "access",
    "updateDate": "2023-11-07T05:31:56Z",
    "userAssignee": {
      "about": "<string>",
      "email": "<string>",
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "<string>",
      "phoneNumber": "<string>",
      "photoUrl": "<string>",
      "surname": "<string>"
    },
    "userRequester": {
      "about": "<string>",
      "email": "<string>",
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "<string>",
      "phoneNumber": "<string>",
      "photoUrl": "<string>",
      "surname": "<string>"
    }
  }
}

POST

support

tickets

Create a support ticket

curl --request POST \
  --url https://api.spacebring.com/support/tickets/v1 \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "ticket": {
    "type": "access",
    "text": "<string>",
    "locationRef": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "userRefRequester": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  }
}
'

{
  "activities": [
    {
      "createDate": "2023-11-07T05:31:56Z",
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "membership": {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "roleType": "<string>",
        "type": "<string>",
        "user": {
          "blocked": true,
          "email": "<string>",
          "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "name": "<string>",
          "surname": "<string>",
          "phoneNumber": "<string>",
          "photoUrl": "<string>"
        }
      },
      "ticketRef": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "type": "comment",
      "data": {
        "attachments": [
          {
            "key": "<string>"
          }
        ],
        "text": "<string>",
        "status": "<string>",
        "membershipAssignee": {
          "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "roleType": "<string>",
          "type": "<string>",
          "user": {
            "blocked": true,
            "email": "<string>",
            "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "name": "<string>",
            "surname": "<string>",
            "phoneNumber": "<string>",
            "photoUrl": "<string>"
          }
        },
        "previousAttributes": {
          "status": "<string>",
          "membershipAssignee": {
            "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "roleType": "<string>",
            "type": "<string>",
            "user": {
              "blocked": true,
              "email": "<string>",
              "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
              "name": "<string>",
              "surname": "<string>",
              "phoneNumber": "<string>",
              "photoUrl": "<string>"
            }
          }
        }
      }
    }
  ],
  "ticket": {
    "createDate": "2023-11-07T05:31:56Z",
    "description": "<string>",
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "locationRef": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "membershipAssignee": {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "roleType": "<string>",
      "type": "<string>",
      "user": {
        "blocked": true,
        "email": "<string>",
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "name": "<string>",
        "surname": "<string>",
        "phoneNumber": "<string>",
        "photoUrl": "<string>"
      }
    },
    "membershipRequester": {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "roleType": "<string>",
      "type": "<string>",
      "user": {
        "blocked": true,
        "email": "<string>",
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "name": "<string>",
        "surname": "<string>",
        "phoneNumber": "<string>",
        "photoUrl": "<string>"
      }
    },
    "membershipRefAssignee": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "membershipRefRequester": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "number": 123,
    "status": "new",
    "type": "access",
    "updateDate": "2023-11-07T05:31:56Z",
    "userAssignee": {
      "about": "<string>",
      "email": "<string>",
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "<string>",
      "phoneNumber": "<string>",
      "photoUrl": "<string>",
      "surname": "<string>"
    },
    "userRequester": {
      "about": "<string>",
      "email": "<string>",
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "<string>",
      "phoneNumber": "<string>",
      "photoUrl": "<string>",
      "surname": "<string>"
    }
  }
}

Authorizations

Authorization

string

header

required

See our authentication documentation for how to authorize your requests

Headers

spacebring-network-id

string<uuid>

The id of the network. Required when using bearer token authentication

Body

application/json

ticket

object

Show child attributes

ticket.type

enum<string>

required

Available options:

access,

accountAndBilling,

bookings,

cleaning,

discriminationAndHarassment,

internet,

mailAndPackages,

noiseAndAcoustics,

offensiveOrObjectionableContent,

other,

printing,

repairAndMaintenance,

temperatureAndVentilation,

websiteAndApp

ticket.text

string

required

The text of the ticket.

ticket.locationRef

string<uuid>

required

The id of the location.

ticket.userRefRequester

string<uuid>

The id of the user who is requesting the ticket.

Response

Created

activities

object[]

Show child attributes

activities.createDate

string<date-time>

The date and time in ISO 8601 format, e.g. 2021-05-21T10:00:00Z

activities.id

string<uuid>

activities.membership

object

Show child attributes

activities.membership.id

string<uuid>

activities.membership.roleType

string

activities.membership.type

string

activities.membership.user

object

Show child attributes

activities.membership.user.blocked

boolean

activities.membership.user.email

string

activities.membership.user.id

string<uuid>

activities.membership.user.name

string

activities.membership.user.surname

string

activities.membership.user.phoneNumber

string

activities.membership.user.photoUrl

string

activities.ticketRef

string<uuid>

activities.type

enum<string>

Available options:

comment,

statusUpdated,

typeUpdated,

assigneeUpdated

activities.data

object

Show child attributes

activities.data.attachments

object[]

Show child attributes

activities.data.attachments.key

string

activities.data.text

string

activities.data.status

string

activities.data.membershipAssignee

object

Show child attributes

activities.data.membershipAssignee.id

string<uuid>

activities.data.membershipAssignee.roleType

string

activities.data.membershipAssignee.type

string

activities.data.membershipAssignee.user

object

Show child attributes

activities.data.membershipAssignee.user.blocked

boolean

activities.data.membershipAssignee.user.email

string

activities.data.membershipAssignee.user.id

string<uuid>

activities.data.membershipAssignee.user.name

string

activities.data.membershipAssignee.user.surname

string

activities.data.membershipAssignee.user.phoneNumber

string

activities.data.membershipAssignee.user.photoUrl

string

activities.data.previousAttributes

object

Show child attributes

activities.data.previousAttributes.status

string

activities.data.previousAttributes.membershipAssignee

object

Show child attributes

activities.data.previousAttributes.membershipAssignee.id

string<uuid>

activities.data.previousAttributes.membershipAssignee.roleType

string

activities.data.previousAttributes.membershipAssignee.type

string

activities.data.previousAttributes.membershipAssignee.user

object

Show child attributes

activities.data.previousAttributes.membershipAssignee.user.blocked

boolean

activities.data.previousAttributes.membershipAssignee.user.email

string

activities.data.previousAttributes.membershipAssignee.user.id

string<uuid>

activities.data.previousAttributes.membershipAssignee.user.name

string

activities.data.previousAttributes.membershipAssignee.user.surname

string

activities.data.previousAttributes.membershipAssignee.user.phoneNumber

string

activities.data.previousAttributes.membershipAssignee.user.photoUrl

string

ticket

object

Show child attributes

ticket.createDate

string<date-time>

The date and time in ISO 8601 format, e.g. 2021-05-21T10:00:00Z

ticket.description

string

ticket.id

string<uuid>

ticket.locationRef

string<uuid>

ticket.membershipAssignee

object

Show child attributes

ticket.membershipAssignee.id

string<uuid>

ticket.membershipAssignee.roleType

string

ticket.membershipAssignee.type

string

ticket.membershipAssignee.user

object

Show child attributes

ticket.membershipAssignee.user.blocked

boolean

ticket.membershipAssignee.user.email

string

ticket.membershipAssignee.user.id

string<uuid>

ticket.membershipAssignee.user.name

string

ticket.membershipAssignee.user.surname

string

ticket.membershipAssignee.user.phoneNumber

string

ticket.membershipAssignee.user.photoUrl

string

ticket.membershipRequester

object

Show child attributes

ticket.membershipRequester.id

string<uuid>

ticket.membershipRequester.roleType

string

ticket.membershipRequester.type

string

ticket.membershipRequester.user

object

Show child attributes

ticket.membershipRequester.user.blocked

boolean

ticket.membershipRequester.user.email

string

ticket.membershipRequester.user.id

string<uuid>

ticket.membershipRequester.user.name

string

ticket.membershipRequester.user.surname

string

ticket.membershipRequester.user.phoneNumber

string

ticket.membershipRequester.user.photoUrl

string

ticket.membershipRefAssignee

string<uuid>

ticket.membershipRefRequester

string<uuid>

ticket.number

integer<int64>

Unique identifier of ticket in location.

ticket.status

enum<string>

Available options:

new,

inProgress,

solved,

closed

ticket.type

enum<string>

Available options:

access,

accountAndBilling,

bookings,

cleaning,

discriminationAndHarassment,

internet,

mailAndPackages,

noiseAndAcoustics,

other,

printing,

repairAndMaintenance,

temperatureAndVentilation,

websiteAndApp

ticket.updateDate

string<date-time>

The date and time in ISO 8601 format, e.g. 2021-05-21T10:00:00Z

ticket.userAssignee

object

Show child attributes

ticket.userAssignee.about

string

ticket.userAssignee.email

string

ticket.userAssignee.id

string<uuid>

ticket.userAssignee.name

string

ticket.userAssignee.phoneNumber

string

ticket.userAssignee.photoUrl

string

ticket.userAssignee.surname

string

ticket.userRequester

object

Show child attributes

ticket.userRequester.about

string

ticket.userRequester.email

string

ticket.userRequester.id

string<uuid>

ticket.userRequester.name

string

ticket.userRequester.phoneNumber

string

ticket.userRequester.photoUrl

string

ticket.userRequester.surname

string

Retrieve support tickets Update support ticket status

⌘I

Getting started

Endpoints

Create a support ticket

OAuth

Authorizations

Headers

Body

Response