Close Ticket API

Close support tickets when issues are resolved or inquiries addressed

Support

Close Ticket API

Close support tickets when issues have been resolved or inquiries have been addressed. Mark tickets as complete to maintain organized support queues.

Mark Resolved

Close tickets when issues are fixed.

Organize Queue

Keep support queues clean.

Track Resolution

Record resolution timestamps.


Endpoint Overview

MUTATION/graphql

Close an existing support ticket by its ID. The ticket status is changed to 'closed' indicating the issue has been resolved.

Authentication:Bearer Token

Request Parameters

idInt!Required

The unique identifier of the ticket to close.


GraphQL Mutation

mutation closeTicket($id: Int!) {
  closeTicket(id: $id) {
    id
    subject
    status
    closedAt
    resolvedBy {
      id
      name
    }
  }
}

Variables:

{
  "id": 12345
}

HTTP Request:

curl -X POST https://api.orbnet.com/graphql \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -d '{
    "query": "mutation closeTicket($id: Int!) { closeTicket(id: $id) { id subject status closedAt } }",
    "variables": {
      "id": 12345
    }
  }'

Response

200Ticket Closed Successfully
{
  "data": {
    "closeTicket": {
      "id": "12345",
      "subject": "Unable to connect to VPN server",
      "status": "closed",
      "closedAt": "2024-01-16T10:00:00Z",
      "resolvedBy": {
        "id": "agent_456",
        "name": "Support Agent"
      }
    }
  }
}
400Ticket Not Found
{
  "errors": [
    {
      "message": "Ticket with ID 12345 not found",
      "path": ["closeTicket"],
      "extensions": {
        "code": "NOT_FOUND"
      }
    }
  ],
  "data": null
}
400Already Closed
{
  "errors": [
    {
      "message": "Ticket is already closed",
      "path": ["closeTicket"],
      "extensions": {
        "code": "ALREADY_CLOSED"
      }
    }
  ],
  "data": null
}

Ticket Statuses

Open

Ticket awaiting response or action.

In Progress

Being actively worked on.

Pending

Waiting for user response.

Closed

Issue resolved, ticket complete.


Best Practices

Confirm Resolution

Ensure issue is fully resolved before closing.

Add Final Reply

Document the resolution in a reply.

User Confirmation

Get user confirmation when possible.

Proper Category

Verify category is correct for reporting.



Reopen if Needed

If an issue recurs after closing, create a new ticket and reference the previous ticket ID.

Bulk Close Tickets

Need to close multiple resolved tickets at once? Use the bulk close endpoint.

Close Multiple Tickets