Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Neo4j Instances API

Manage AuraDB cloud database instances including provisioning, configuration, lifecycle operations such as pause and resume, and deletion.

Neo4j Instances API is one of 12 APIs that Neo4j publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Instances. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 8 operations across 5 paths, and defines 6 schemas. It is described by OpenAPI 3.1.0, at version 1.0.

Requests are made against a single base URL, https://api.neo4j.io/v1.

8 operations 5 paths 6 schemas 1 DELETE2 GET1 PATCH4 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
1.0
Server
https://api.neo4j.io/v1
Authentication
HTTP Bearer
Terms of Service
Resource Areas
1

Authentication & Security 1

Neo4j Instances API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (bearerAuth). By default, every request must be authenticated.

  • bearerAuth — OAuth2 bearer token obtained from the /oauth/token endpoint using client credentials. Tokens expire after one hour.

Paths & Operations 8

Across 5 paths, the API surfaces 8 operations — 1 DELETE, 2 GET, 1 PATCH, 4 POST. Each is listed below with its method, path, parameters, and response codes.

Instances 8

Manage AuraDB cloud database instances including provisioning, configuration, lifecycle operations such as pause and resume, and deletion.

GET
/instances
List all instances
listInstances 1 param → 200401403
POST
/instances
Create a new instance
createInstance body → 202400401403
GET
/instances/{instanceId}
Get instance details
getInstance 1 param → 200401404
PATCH
/instances/{instanceId}
Update an instance
updateInstance 1 param body → 200400401404
DELETE
/instances/{instanceId}
Delete an instance
deleteInstance 1 param → 202401404
POST
/instances/{instanceId}/pause
Pause an instance
pauseInstance 1 param → 200401404
POST
/instances/{instanceId}/resume
Resume a paused instance
resumeInstance 1 param → 200401404
POST
/instances/{instanceId}/overwrite
Overwrite an instance from a snapshot
overwriteInstance 1 param body → 200400401404

Schemas 6

The contract defines 6 schemas that model the data the API accepts and returns. The most detailed are Instance (12 properties), CreateInstanceRequest (7 properties), InstanceCreated (7 properties), UpdateInstanceRequest (2 properties). Each schema is shown below with its type and property counts.

InstanceCreated
object
Response when an instance is created, including initial credentials.
7 properties
OverwriteInstanceRequest
object
Request body for overwriting an instance from a snapshot.
2 properties 2 required
AuraError
object
Error response from the Aura API.
1 property
Instance
object
An AuraDB cloud database instance.
12 properties
CreateInstanceRequest
object
Request body for creating a new AuraDB instance.
7 properties 6 required
UpdateInstanceRequest
object
Request body for updating an instance configuration.
2 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

neo4j-instances-api-openapi.yml Raw ↑

Other APIs Neo4j publishes across the network.

Neo4j Query API
Neo4j GraphQL Library
Neo4j Bolt Protocol
Neo4j Python Driver
Neo4j Java Driver
Neo4j JavaScript Driver
Neo4j Authentication API
Neo4j Discovery API
Neo4j Snapshots API
Neo4j Tenants API
Neo4j Transactions API