Shovels · Agentic Access

Shovels Agentic Access

x-agentic-access generated

Shovels exposes 21 API operations that an AI agent could call, of which 0 are state-changing ‘acting’ operations. This is a recommended x-agentic-access execution contract — the scope, audience, consequence tier, short-lived token constraints, and escalation each action should carry before it is handed to an autonomous agent.

By consequence: 21 read.

Contracts are classified heuristically from the provider’s OpenAPI and refresh on every APIs.io network build; audience is bound per deployment. The model follows Curity’s Access Intelligence (apidays Munich 2026). Browse every provider’s agent contracts at agentic-access.apis.io.

ConstructionBuilding PermitsContractorsReal EstateProperty DataMarket Intelligence

Operations: 21 Acting: 0 Human-in-the-loop: 0 Method: generated

By consequence

Source

Agentic Access

generated: '2026-07-15'
method: generated
source: openapi/shovels-openapi.yml
description: Recommended x-agentic-access execution contracts, classified heuristically from
  the OpenAPI. A governance starting point for exposing this API to AI agents — review and bind
  audience per deployment. See research/curity/agentic-governance/.
summary:
  operations: 21
  by_action_class:
    connected: 21
  by_consequence:
    read: 21
  human_in_the_loop_required: 0
operations:
- path: /permits/search
  method: get
  operationId: searchPermits
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /permits/{id}
  method: get
  operationId: getPermitById
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /contractors/search
  method: get
  operationId: searchContractors
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /contractors/{id}
  method: get
  operationId: getContractorById
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /contractors/{id}/permits
  method: get
  operationId: getContractorPermits
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /contractors/{id}/employees
  method: get
  operationId: getContractorEmployees
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /contractors/{id}/metrics
  method: get
  operationId: getContractorMetrics
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /addresses/search
  method: get
  operationId: searchAddresses
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /addresses/{geo_id}/metrics/current
  method: get
  operationId: getAddressMetricsCurrent
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /addresses/{geo_id}/metrics/monthly
  method: get
  operationId: getAddressMetricsMonthly
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /addresses/{geo_id}/residents
  method: get
  operationId: getAddressResidents
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /cities/search
  method: get
  operationId: searchCities
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /cities/{geo_id}
  method: get
  operationId: getCityById
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /cities/{geo_id}/metrics/current
  method: get
  operationId: getCityMetricsCurrent
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /counties/search
  method: get
  operationId: searchCounties
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /jurisdictions/search
  method: get
  operationId: searchJurisdictions
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /states/search
  method: get
  operationId: searchStates
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /zipcodes/search
  method: get
  operationId: searchZipcodes
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /tags
  method: get
  operationId: getTags
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /meta/release-date
  method: get
  operationId: getMetaReleaseDate
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /usage
  method: get
  operationId: getUsage
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none