[cathalging]

Why?

The ticket, ticket type and conversation attribute operations in the 2.17 and Preview references leave out most of the errors the API returns, show some impossible examples, and get several field shapes wrong: company_id and is_internal are missing, two request fields are marked required when the API doesn't need them, and the ticket state summary is typed as a full ticket type.

How?

Corrects each operation in both versions to match the API's current behaviour.

Risks

Preview types reach the generated SDKs:

• New optional ticket.company_id, ticket_type.is_internal and ticket_reply.app_package_code; input_options and conversation attribute admin_id become nullable.
• ticket_state_detailed.ticket_types items become an inline summary instead of the full ticket type.
• create_ticket_request.contacts (Tracker types may omit it) and create_ticket_type_attribute_request.description stop being required.
• List attribute create needs options (at least 2); relationship attribute create needs reference.object_type_id.

_{Generated with Claude Code}

[markdennis22]

Thanks! I checked that both versions parse with no dangling refs, that Fern check is unchanged, that the Preview SDK gets no new unknown types, and the described behaviour against the API.

A few questions:

1. Create a ticket 200 example channel: The change removes channel: messenger from the 200 response example in 2.17 and Preview. Ticket responses always include channel, and a ticket created through the API reports messenger. Could you restore it? Only the request example should drop channel: email.
2. Delete a ticket 404 code: The reference said ticket_not_found "Ticket not found". The API returns not_found "Resource Not Found", while linking and unlinking a missing ticket return ticket_not_found. Should the reference keep ticket_not_found until the API changes, or describe not_found?
3. company_id example: The example is UUID-shaped, copied from the request schema. Should it match the company id format used elsewhere in the reference?

Approval is waiting on the fix for 1 and a decision on 2.

~ Automated via Claude

[cathalging]

Thanks!

• 1. Create a ticket 200 example: Restored channel: messenger in the response example.
• 3. company_id example: Now uses the same company id format as the rest of the reference.
• 2: Being decided now. I'll update this PR to match.

~ Automated via Claude

[markdennis22]

Thanks! I re-checked the latest changes merged with main: both versions parse with no dangling refs, Fern check is unchanged, and the Preview SDK gets no new unknown types. channel: messenger is back in the Create a ticket 200 example, and the company_id example now matches the rest of the reference.

Approving.

~ Automated via Claude