Aura Historia · Schema

PatchAccessTokenData

Request body for updating access-token metadata. Omitted fields remain unchanged. `expires: null` clears the expiry; `name` and `scopes` reject null, and `scopes: []` replaces the scope set with an empty set.

CompanyAntiquesMarketplaceSearchSoftware-as-a-Service

Properties

Name Type Description
accessTokenId string Unique identifier of the access token to update.
name string Omit to leave unchanged. Null is invalid.
scopes array Omit to leave unchanged. Send `[]` to empty the set; null is invalid. Aura Historia access tokens may only send a subset of the current scopes.
expires stringnull Omit to leave unchanged. Send null to clear the expiration timestamp. Aura Historia access tokens cannot clear or extend an existing expiry.
View JSON Schema on GitHub

JSON Schema

aura-historia-com-patch-access-token-data-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/aura-historia-com/json-schema/aura-historia-com-patch-access-token-data-schema.json",
  "title": "PatchAccessTokenData",
  "description": "Request body for updating access-token metadata.\nOmitted fields remain unchanged. `expires: null` clears the expiry; `name` and `scopes`\nreject null, and `scopes: []` replaces the scope set with an empty set.\n",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/aura-historia-com-user-account-api-openapi.yml#/components/schemas/PatchAccessTokenData",
  "type": "object",
  "required": [
    "accessTokenId"
  ],
  "properties": {
    "accessTokenId": {
      "type": "string",
      "description": "Unique identifier of the access token to update."
    },
    "name": {
      "type": "string",
      "maxLength": 128,
      "description": "Omit to leave unchanged. Null is invalid."
    },
    "scopes": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/AccessTokenScopeData"
      },
      "uniqueItems": true,
      "description": "Omit to leave unchanged. Send `[]` to empty the set; null is invalid. Aura Historia access tokens may only send a subset of the current scopes."
    },
    "expires": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time",
      "description": "Omit to leave unchanged. Send null to clear the expiration timestamp. Aura Historia access tokens cannot clear or extend an existing expiry."
    }
  },
  "$defs": {
    "AccessTokenScopeData": {
      "type": "string",
      "enum": [
        "auctions:read",
        "auctions:write",
        "listing-sources:read",
        "parties:read",
        "parties:write",
        "partnership-applications:read",
        "partnership-applications:write",
        "partnerships:read",
        "partnerships:write",
        "admin-overview:read",
        "search-filters:read",
        "notifications:read",
        "notifications:write",
        "product-listings:read",
        "product-listings:write",
        "listing-sources:write",
        "users:read",
        "users:write",
        "access-tokens:read",
        "access-tokens:write",
        "search-filters:write",
        "watchlist:read",
        "watchlist:write"
      ],
      "description": "Aura Historia access-token and OAuth scope string.\nThe value is one of the capabilities supported by the canonical access-token and OAuth flows.\n"
    }
  }
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this
  • find_json_schemasBrowse and filter every JSON Schema in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/aura-historia-com-patch-access-token-data"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.