Document include=assets as the way to see a ticket's associated assets
The /tickets/{id}/associated-assets path 404s on this instance; assets come
back embedded via GET /tickets/{id}?include=assets. Spell out the full include
list on get_ticket and in the skill reference so consumers don't hunt for a
nonexistent endpoint.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
@@ -303,7 +303,11 @@ def list_ticket_statuses() -> str:
|
|||||||
|
|
||||||
@mcp.tool()
|
@mcp.tool()
|
||||||
def get_ticket(ticket_id: int, include: str | None = None) -> str:
|
def get_ticket(ticket_id: int, include: str | None = None) -> str:
|
||||||
"""Get a ticket by id. `include` e.g. "conversations,requester,stats".
|
"""Get a ticket by id. `include` accepts a comma-separated subset of:
|
||||||
|
conversations, requester, requested_for, stats, problem, assets, tags,
|
||||||
|
related_tickets. NOTE: include=assets is the ONLY way to see the ticket's
|
||||||
|
associated CMDB assets (a /tickets/{id}/associated-assets path does not
|
||||||
|
exist — it 404s); the assets come back embedded in the ticket object.
|
||||||
Numeric enums come back with companion *_label fields (priority_label,
|
Numeric enums come back with companion *_label fields (priority_label,
|
||||||
status_label, impact_label, urgency_label) — use those names, never guess
|
status_label, impact_label, urgency_label) — use those names, never guess
|
||||||
the scale (priority 4 is Urgent, not low)."""
|
the scale (priority 4 is Urgent, not low)."""
|
||||||
|
|||||||
@@ -86,6 +86,11 @@ lists which ones they're in).
|
|||||||
- `GET /tickets` supports `filter` presets (`new_and_my_open`, `watching`,
|
- `GET /tickets` supports `filter` presets (`new_and_my_open`, `watching`,
|
||||||
`spam`, `deleted`), `updated_since`, `order_by`, `order_type`, `page`,
|
`spam`, `deleted`), `updated_since`, `order_by`, `order_type`, `page`,
|
||||||
`per_page` (max 100), and `include` (`conversations`, `requester`, `stats`).
|
`per_page` (max 100), and `include` (`conversations`, `requester`, `stats`).
|
||||||
|
- `GET /tickets/{id}?include=assets` is the **only** way to see a ticket's
|
||||||
|
associated CMDB assets — they come back embedded in the ticket object. There
|
||||||
|
is no `/tickets/{id}/associated-assets` endpoint (it 404s). Other
|
||||||
|
single-ticket includes: `conversations`, `requester`, `requested_for`,
|
||||||
|
`stats`, `problem`, `tags`, `related_tickets`.
|
||||||
- `GET /tickets/filter?query="..."` is for ad-hoc field queries (also 100/page).
|
- `GET /tickets/filter?query="..."` is for ad-hoc field queries (also 100/page).
|
||||||
|
|
||||||
## Pagination & rate limits
|
## Pagination & rate limits
|
||||||
|
|||||||
Reference in New Issue
Block a user