id-of-tickets-post

dci id-of-tickets-post

Creates a new support request

Request

Content-Type: application/json

Schema

{
  "type": "object",
  "description": "Wrapper object for creating support tickets via the external API.",
  "x-cloudflow-labels": {
    "ticket": "Ticket details"
  },
  "properties": {
    "ticket": {
      "type": "object",
      "description": "Payload to create a support ticket via API.",
      "required": [
        "body",
        "platform",
        "product",
        "severity"
      ],
      "properties": {
        "body": {
          "type": "string",
          "description": "The body of the ticket (can include html formatting).",
          "x-cloudflow-format": "multiReference"
        },
        "created": {
          "type": "string",
          "description": "Ticket creation time."
        },
        "platform": {
          "type": "string",
          "description": "Platform of the ticket.",
          "enum": [
            "doit",
            "google_cloud_platform",
            "amazon_web_services",
            "microsoft_azure"
          ]
        },
        "product": {
          "type": "string",
          "description": "Ticket product details."
        },
        "severity": {
          "type": "string",
          "description": "Ticket severity.",
          "enum": [
            "low",
            "normal",
            "high",
            "urgent"
          ],
          "x-cloudflow-format": "noReference"
        },
        "subject": {
          "type": "string",
          "description": "The subject of the ticket."
        }
      }
    }
  },
  "required": [
    "ticket"
  ]
}

Responses

201 (application/json)

Created - New support request created.

{
  "type": "object",
  "description": "Response returned after creating a ticket.",
  "properties": {
    "created": {
      "type": "integer",
      "description": "Ticket creation time.",
      "format": "int64"
    },
    "id": {
      "type": "integer",
      "description": "Ticket ID.",
      "format": "int64"
    },
    "platform": {
      "type": "string",
      "description": "Ticket platform.",
      "enum": [
        "doit",
        "google_cloud_platform",
        "amazon_web_services",
        "microsoft_azure"
      ]
    },
    "product": {
      "type": "string",
      "description": "Ticket product."
    },
    "requester": {
      "type": "string",
      "description": "Email address of the requester."
    },
    "severity": {
      "type": "string",
      "description": "Severity of the ticket.",
      "enum": [
        "low",
        "normal",
        "high",
        "urgent"
      ]
    },
    "status": {
      "type": "string",
      "description": "Ticket status."
    },
    "subject": {
      "type": "string",
      "description": "Ticket subject."
    },
    "urlUI": {
      "type": "string",
      "description": "URL to access the ticket in DoiT console."
    }
  }
}

400 (application/json)

Bad Request - The server cannot process the request, often due to a malformed request.

{
  "type": "object",
  "description": "Standard error response structure.",
  "properties": {
    "error": {
      "type": "string",
      "description": "Detailed error message."
    }
  }
}

401 (application/json)

Unauthorized - Invalid API key.

{
  "type": "object",
  "description": "Standard error response structure.",
  "properties": {
    "error": {
      "type": "string",
      "description": "Detailed error message."
    }
  }
}

403 (application/json)

Forbidden - The client is not authorized to perform the request.

{
  "type": "object",
  "description": "Standard error response structure.",
  "properties": {
    "error": {
      "type": "string",
      "description": "Detailed error message."
    }
  }
}

404 (application/json)

Not Found - The requested resource does not exist.

{
  "type": "object",
  "description": "Standard error response structure.",
  "properties": {
    "error": {
      "type": "string",
      "description": "Detailed error message."
    }
  }
}

Aliases: id-of-tickets-post, idofticketspost