Skip to content
adversarial

Search the provider for tickets

GET
/v1/integrations/{provider}/{installation_id}/configs/{config_id}/tickets/search
curl --request GET \
  --url 'https://api.adversarial.com/api/v1/integrations/example/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/configs/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/tickets/search?query=example'

Returns tickets an operator can link to a register item.

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
provider
required
string
installation_id
required
string format: uuid
config_id
required
string format: uuid

Query Parameters

Section titled “Query Parameters”
query
required
string

Text matched against provider tickets.

project
string

Optional project/team scope. Required for ServiceNow (the table).

Responses

Section titled “Responses”

200

Section titled “200”
Media typeapplication/json
Array<object>

A generic preview of an external ticket for autocomplete and linked-ticket display. Works across all ticket integrations (Jira, ServiceNow, etc.).

object
available
required

false when the external system no longer returns this ticket (a dangling link kept visible only so the user can unlink it); true for live tickets. Synthesized unresolved previews set this to false.

boolean
id
required

Opaque external ticket ID.

string
image
required

Icon URL for the ticket type.

string
key
required

Human-readable ticket key (e.g. “PROJ-123”, “INC0012345”).

string
summary
required

Short summary/title.

string
table

The source table the ticket lives in (e.g. “incident”); null when the integration has no such concept.

string | null
url
required

URL to view the ticket in the external system.

string
Examplegenerated
[
  {
    "available": true,
    "id": "example",
    "image": "example",
    "key": "example",
    "summary": "example",
    "table": "example",
    "url": "example"
  }
]