User guide
Task-oriented guides for the SDK's core features. If you're new, start with Getting Started and then Core Concepts — the rules the guides below build on.
- Migrating from v1 to v2: Coming from a 1.x release? Map every v1 construct to its v2 replacement.
- Support Policy: Which Go versions and SDK versions are supported, and for how long.
- Authentication: Choose and configure a credential flow — Basic, OAuth2 authorization code, client credentials, JWT bearer, or ROPC.
- Table Operations: Create, read, update, and delete records in any ServiceNow table.
- Attachments: Upload, download, list, and clean up files attached to records.
- Batch Operations: Combine multiple requests into a single HTTP call.
- Pagination: Iterate over large result sets with page iterators.
- More APIs: Task guides for every other supported module — from aggregate stats and CMDB queries to CSM cases and the CDM workflow.
- Handling Errors: Match API and usage errors with
errors.As/errors.Is. - Configuring the Client: Middleware, retries, logging, and transport options.
- Querying: Build encoded queries fluently (preview feature).