This page describes AAES Govern’s controls. AAES Operate has private-work permissions, operational reviews and recorded-spend limits; it does not include Govern. About AAES Govern
Before you enable this package
The instance host is a reserved .invalid placeholder that fails closed until substituted. The Table API enforces the calling user's ACLs: the registration records the endpoint, not the instance's authorization decision. Change-request approval is a documented exclusion, not a registered capability.
Read each action's effects and exclusions below. Before installation, also read the complete package requirements, including credential issuance, scope, expiry, and provider permissions. These are deployment prerequisites, not capabilities this package supplies.
Capabilities (6)
Each capability below is one registered operation. The complete package JSON includes its exact network destination allowlist. The repository stores it at packs/servicenow.json and embeds a copy in the release binary.
Risk tiers. R0 is the minimum for reads. R2 is the minimum for write, create, update, execute, and invoke. R3 is the minimum for delete, send, pay, deploy, approve, share, and transfer. Operators can raise these levels. A minimum tier does not measure the operation's business or confidentiality risk.
Field guide. Endpoint is the service address and request method. Connector is the adapter that makes the call. Custody describes how the credential is held; the credential reference identifies the value to resolve. Data class sets handling requirements: pii means personal data, financial means financial records, and internal means internal organizational data.
servicenow.incident.read v1.0.0R0
- Kind
- tool
- Action
- read
- Endpoint
GET https://servicenow-instance.invalid/api/now/table/incident- Connector
- http
- Custody
- customer_vault
- Credential ref
secret-ref-servicenow-oauth-token- Data class
- pii
Read incident.
Retrieve incident records from the collection endpoint; this pack registers the collection read only — the Table API's single-record read (GET /now/table/{tableName}/{sys_id}) is not registered. Incident records carry caller, assignee and watch-list user references, so the read is classified as pii (personal data).
The host is a reserved placeholder: substitute the customer's instance host before enabling.
servicenow.incident.create v1.0.0R2
- Kind
- tool
- Action
- create
- Endpoint
POST https://servicenow-instance.invalid/api/now/table/incident- Connector
- http
- Custody
- customer_vault
- Credential ref
secret-ref-servicenow-oauth-token- Data class
- pii
Create incident.
Insert one incident record; the Table API inserts one record per call and does not support multiple-record insertion. The record can name a caller and other users, so the capability is classified as pii (personal data).
The host is a reserved placeholder: substitute the customer's instance host before enabling.
servicenow.incident.update v1.0.0R2
- Kind
- tool
- Action
- update
- Endpoint
PATCH https://servicenow-instance.invalid/api/now/table/incident/SYS_ID- Connector
- http
- Custody
- customer_vault
- Credential ref
secret-ref-servicenow-oauth-token- Data class
- pii
Update incident.
Update one incident record with the name-value pairs in the request body; fields prefixed sys_ are system-generated and cannot be updated. The Table API also documents PUT for updates; this pack registers PATCH only.
The host is a reserved placeholder to substitute before enabling, and SYS_ID binds to the target record at call time.
servicenow.change_request.read v1.0.0R0
- Kind
- tool
- Action
- read
- Endpoint
GET https://servicenow-instance.invalid/api/now/table/change_request- Connector
- http
- Custody
- customer_vault
- Credential ref
secret-ref-servicenow-oauth-token- Data class
- pii
Read change request.
Retrieve change request records from the collection endpoint; this pack registers the collection read only — the Table API's single-record read (GET /now/table/{tableName}/{sys_id}) is not registered. Change requests carry requested-by and assigned-to user references, so the read is classified as pii (personal data).
The host is a reserved placeholder: substitute the customer's instance host before enabling.
servicenow.change_request.create v1.0.0R2
- Kind
- tool
- Action
- create
- Endpoint
POST https://servicenow-instance.invalid/api/now/table/change_request- Connector
- http
- Custody
- customer_vault
- Credential ref
secret-ref-servicenow-oauth-token- Data class
- pii
Create change request.
Insert one change request record; the Table API inserts one record per call. The insert accepts the name-value pairs the calling user is permitted to set, subject to the instance's ACLs and business rules — this registration does not restrict which fields a request may carry, so what workflow state a newly inserted record enters, and whether it starts unapproved, is decided by the instance's configuration, not by this pack.
Nothing in this pack approves a change: the approval capability was considered and removed (see the pack notes).
The host is a reserved placeholder: substitute the customer's instance host before enabling.
servicenow.catalog_item.read v1.0.0R0
- Kind
- tool
- Action
- read
- Endpoint
GET https://servicenow-instance.invalid/api/now/table/sc_cat_item- Connector
- http
- Custody
- customer_vault
- Credential ref
secret-ref-servicenow-oauth-token- Data class
- internal
Read catalog item.
Retrieve service catalog item records from the collection endpoint; this pack registers the collection read only. Catalog items are the organization's catalog content, classified as internal data; this reads the catalog only — ordering an item is the Service Catalog API (order_now), which this pack does not register.
The host is a reserved placeholder: substitute the customer's instance host before enabling.
Credential reference
The credential field names a reference rather than containing credential material. Packs are designed not to contain secrets; the format checks cover only known credential formats and cannot prove that arbitrary text contains no secrets. Installing a package registers its capabilities. Configure the provider credentials, endpoints, and network access, then test the integration in your environment before enabling it.
- Reference
secret-ref-servicenow-oauth-token- Custody
- customer_vault
- Injection
- header (Authorization)
Configure the value and injection format specified in the package. Assign responsibility for credential rotation and revocation, restrict provider permissions, and keep credential material out of logs and responses.
Complete credential requirements
An OAuth2 access token for the customer's own ServiceNow instance, held in the client's own secret manager. The stored material must be the complete Authorization header value (scheme included): 'Bearer ' followed by the access token. An external deployment process obtains the token from the instance and renews it when it expires — storing the OAuth client credentials under this reference does not make the HTTP injector perform OAuth: the injector injects the stored value verbatim, so refresh ownership (including any refresh-token grant the deployment chooses to use) sits entirely with that external process.
Access tokens expire and can be revoked at the instance; an expired or revoked value fails closed. The token's access is the token user's access — grant the user the minimum roles (for example itil for the incident and change tables) that make these capabilities work, and nothing more.
Executor hygiene: the value must live only in executor memory for the lifetime of a call, must never be written to logs, traces or diagnostics, and must not appear in crash dumps; a deployment that cannot meet that bar must not enable the pack.
Resources
servicenow-instance(api, pii):https://servicenow-instance.invalid/api/now
Technical package and review record
Complete provider requirements and exclusions
The endpoint host 'servicenow-instance.invalid' is a reserved non-production placeholder (an RFC 2606 reserved TLD): substitute the customer's instance host before enabling, in every endpoint, in the resource locator and in every egress allowlist entry. The allowlist matches exactly, so endpoints and allowlist must be substituted together, and substitution is a required deployment step — the reserved host being allowlisted does not make an unsubstituted pack safe to enable.
The pack does not create the OAuth application or mint tokens: an external deployment process registers the OAuth client with the instance admin, obtains access tokens from the customer's own instance, and stores and renews the complete header value described in the credential note. The Table API enforces the calling user's ACLs and roles, so a capability works only if the token's user (for example an itil user) is permitted the operation; the registration records the endpoint, not the instance's authorization decision.
Excluded operation: servicenow.change_request.approve. Approving a change request by PATCHing the record's approval field was considered and removed — the retrieved Table API documentation establishes PATCH /now/table/{tableName}/{sys_id} as a generic name-value update but does not establish that setting the change_request record's approval field performs a workflow approval; change approvals run through approval records and the Change Management REST API's approval operation, each a different registration requiring its own review, and this pack registers neither.
Nothing in this pack approves a change. Further documented exclusions, from the retrieved Table API documentation: DELETE /now/table/{tableName}/{sys_id} exists in the API and is deliberately not registered; incident or change deletion is excluded; PUT /now/table/{tableName}/{sys_id} also exists, and only PATCH is registered for updates; POST inserts one record per call — multiple-record insertion is not supported by the Table API.
The Attachment API, Stats API, Import Set API and Service Catalog API (order_now) are separate ServiceNow APIs this pack does not register — reading sc_cat_item returns catalog content and orders nothing. AAES has not been certified by ServiceNow; the endpoints here are configuration to review and test; the vendor has not endorsed it.
Download the complete package JSON for exact network allowlists, credential requirements, exclusions, and setup notes. Read these requirements before installation.
The full documentation review record is supplied in the evaluation package. The evaluation package runs in your environment and comes only with the paid design partnership. This page reproduces the source links and review block; the full record is available for evaluation. Discuss a design partnership to inspect it before installation.
Review block
This section reproduces the review block recorded in the pack file. The evidence and approval record is separate: for a reviewed pack, it is in the evaluation materials and in the release binary's embedded assets.
Review completed: 2026-09-23
3 sources, retrieved 2026-09-21, 2026-09-23
- https://www.servicenow.com/docs/bundle/zurich-api-reference/page/integrate/inbound-rest/concept/c_TableAPI.html (retrieved 2026-09-21)
- https://www.servicenow.com/docs/api/khub/maps/MVRCUFVyKWd7vUoUukbW6g/topics/bRERdJSjwCv6ACu52tHaCw/content (retrieved 2026-09-23)
- https://www.rfc-editor.org/rfc/rfc6750.txt (retrieved 2026-09-23)
Current documentation links are navigation aids. They do not change the package, its historical sources or its review date. Review dates describe a documentation review, not a live integration test. No package is provider-endorsed or yet tested against a live provider tenant.
Release identity
SHA-256 of the pack file bytes: fb544a6f963eba2e0ab01537d6085bd1c39fd2c2d93ad5dbb394b2884440c608
Distributable: yes, digest matches the release manifest. Editing a package changes its release identity. A deployment plan checks its own file digests; it does not restore reviewed status or authenticate approval.