REST API reference

      +
      The REST API supports the management of Couchbase-Server clusters.

      The REST API supports the management of Couchbase-Server clusters. This includes cluster-creation and the definition of nodes, services, and server groups. The API also supports the extensive retrieval of statistics.

      This page provides a complete list of HTTP methods and URIs. It also lists HTTP Request Headers and HTTP Response Codes.

      Nodes and Clusters API

      The Cluster API provides support for managing and retrieving information on clusters. It also provides support for managing rebalance, failover, and server group awareness. The APIs for each area are assigned a table, below.

      Cluster Initialization and Provisioning

      HTTP Method URI Documented at

      POST

      /clusterInit

      Initialize a Cluster

      POST

      /nodes/self/controller/settings

      Initializing a Node

      POST

      /settings/web

      Establishing Credentials

      POST

      /node/controller/rename

      Naming a Node

      POST

      /pools/default

      Configuring Memory

      POST

      /node/controller/setupServices

      Assigning Services

      POST

      /pools/default

      Naming a Cluster

      Node Addition and Removal

      HTTP Method URI Documented at

      POST

      /controller/addNode

      Adding Nodes to Clusters

      POST

      /node/controller/doJoinCluster

      Joining Nodes to Clusters

      POST

      /controller/ejectNode

      Removing Nodes from Clusters

      Rebalance

      HTTP Method URI Documented at

      POST

      /controller/rebalance

      Rebalancing the Cluster

      GET

      /pools/default

      Getting Rebalance Reason Codes

      GET

      /pools/default/rebalanceProgress

      Getting Rebalance Progress

      GET

      /pools/default/retryRebalance

      Configuring Rebalance Retries

      POST

      /pools/default/retryRebalance

      Configuring Rebalance Retries

      GET

      /pools/default/pendingRetryRebalance

      Getting Rebalance-Retry Status

      POST

      /controller/cancelRebalanceRetry/<rebalance-id>

      Canceling Rebalance Retries

      GET

      /settings/rebalance

      Limiting Concurrent vBucket Moves

      POST

      /settings/rebalance

      Limiting Concurrent vBucket Moves

      POST

      /internalSettings

      Disabling Consistent View Query Results on Rebalance

      Manual-Failover

      HTTP Method URI Documented at

      POST

      /controller/failOver

      Performing Hard Failover

      POST

      /controller/startGracefulFailover

      Performing Graceful Failover

      POST

      /controller/setRecoveryType

      Setting Recovery Type

      Auto-Failover

      HTTP Method URI Documented at

      GET

      /settings/autoFailover

      Retrieving Auto-Failover Settings

      POST

      /settings/autoFailover

      Enabling and Disabling Auto-Failover

      POST

      /settings/autoFailover/resetCount

      Resetting Auto-Failover

      POST

      /controller/setRecoveryType

      Setting Recovery Type

      Settings and Connections

      HTTP Method URI Documented at

      GET

      /internalSettings

      Managing Internal Settings

      POST

      /internalSettings

      Managing Internal Settings

      GET

      /settings/maxParallelIndexers

      Managing Internal Settings

      POST

      /settings/maxParallelIndexers

      Managing Internal Settings

      GET

      /pools/default/settings/memcached/global

      Managing Cluster Connections

      POST

      /pools/default/settings/memcached/global

      Managing Cluster Connections

      PUT

      /node/controller/setupAlternateAddresses/external

      Managing Alternate Addresses

      DELETE

      /node/controller/setupAlternateAddresses/external

      Managing Alternate Addresses

      GET

      /settings/alerts

      Getting Alert Settings

      POST

      /settings/alerts

      Enabling and Disabling Email Notifications

      POST

      /settings/alerts/sendTestEmail

      Sending Test Emails

      Status and Events

      HTTP Method URI Documented at

      GET

      /pools/default/tasks

      Getting Cluster Tasks

      GET

      /logs/rebalanceReport?reportID=<report-id>

      Getting Cluster Tasks

      GET

      /pools

      Retrieving Cluster Information

      GET

      /pools/default

      Viewing Cluster Details

      GET

      /events

      Getting System Events

      GET

      /eventsStreaming

      Getting System Events

      GET

      /pools/default/terseClusterInfo

      Identifying the Orchestrator Node

      GET

      /pools/nodes

      Getting Information on Nodes

      GET

      /pools/default/nodeServices

      Listing Node Services

      Statistics

      HTTP Method URI Documented at

      GET

      /prometheus_sd_config

      Prometheus Discovery API

      GET

      /pools/default/stats/range/<metric_name>/[function-expression]

      Getting a Single Statistic

      POST

      /pools/default/stats/range

      Getting Multiple Statistics

      Logging

      HTTP Method URI Documented at

      POST

      /controller/startLogsCollection

      Collecting Logs

      POST

      /controller/cancelLogsCollection

      Collecting Logs

      GET

      /pools/default/tasks

      Getting Cluster Tasks

      GET

      /diag

      Retrieving Diagnostic and Log Information

      GET

      /sasl_logs

      Retrieving Diagnostic and Log Information

      POST

      /logClientError

      Logging Client-Side Errors

      Buckets API

      Couchbase Server keeps items in buckets. Before an item can be saved, a bucket must exist for it. Buckets can be created and managed by means of the following REST API.

      HTTP Method URI Documented at

      POST

      /pools/default/buckets

      Creating and Editing Buckets

      POST

      /pools/default/buckets/<bucketName>

      Creating and Editing Buckets

      GET

      /pools/default/buckets

      Getting Bucket Information

      GET

      /pools/default/buckets/<bucket-name>

      Getting Bucket Information

      POST

      /pools/default/buckets/<bucket-name>/nodes

      Listing Nodes by Bucket

      GET

      /pools/default/buckets/[bucket-name]/stats

      Getting Bucket Statistics

      GET

      /pools/default/buckets/default

      Getting Bucket Streaming URI

      DELETE

      /pools/default/buckets/[bucket-name]

      Deleting Buckets

      DELETE

      /pools/default/buckets/[bucket-name]

      Deleting Buckets

      POST

      /pools/default/buckets/[bucket-name]/controller/doFlush

      Flushing Buckets

      GET

      /sampleBuckets

      Managing Sample Buckets

      POST

      /sampleBuckets/install

      Managing Sample Buckets

      Scopes and Collections API

      Couchbase Server provides scopes and collections; allowing documents to be categorized and organized, within a bucket. The REST API provided for the creation and management of scopes and collections is listed below.

      HTTP Method URI Documented at

      POST

      /pools/default/buckets/<bucket_name>/scopes

      Creating a Scope

      POST

      /pools/default/buckets/<bucket_name>/scopes/<scope_name>/collections

      Creating a Collection

      GET

      /pools/default/buckets/<bucket_name>/scopes/

      Listing Scopes and Collections

      DELETE

      /pools/default/buckets/<bucket_name>/scopes/<scope_name>/collections/<collection_name>

      Dropping a Collection

      DELETE

      /pools/default/buckets/<bucket_name>/scopes/<scope_name>

      Dropping a Scope

      Memory and Storage API

      Memory quotas can be allocated to services, and the current allocations retrieved. During cluster initialization, the on-disk paths for services can be specified on a per node basis.

      Reader and writer threads can be configured, to ensure that disk access is highly performant.

      Compaction can be managed: this is used by Couchbase Server to relocate on-disk data; so as to ensure the data’s closest-possible proximity, and thereby reclaim fragments of unused disk-space. The periodic compaction of a bucket’s data helps to ensure the ongoing efficiency of both reads and writes.

      HTTP Method URI Documented at

      POST

      /nodes/self/controller/settings

      Initializing a Node

      POST

      /pools/default

      Configuring Memory

      POST

      /pools/default/settings/memcached/global

      Setting Thread Allocations

      GET

      /nodes/self

      Getting Storage Information

      POST

      /pools/default/buckets/[bucket-name]/controller/compactBucket

      Performing Compaction Manually

      POST

      /pools/default/buckets/[bucket-name]/controller/cancelBucketCompaction

      Performing Compaction Manually

      GET

      /settings/autoCompaction

      Auto-Compaction: Global

      POST

      /controller/setAutoCompaction

      Auto-Compaction: Global

      GET

      /pools/default/buckets/[bucket-name]

      Auto-Compaction: Per Bucket

      POST

      /pools/default/buckets/[bucket-name]

      Auto-Compaction: Per Bucket

      Server Groups API

      Server Group Awareness provides enhanced availability. Specifically, it protects a cluster from large-scale infrastructure failure, through the definition of groups. Its REST API is expressed by the following table.

      HTTP Method URI Documented at

      GET

      /pools/default/serverGroups

      Getting Group Information

      POST

      /pools/default/serverGroups

      Creating Groups

      POST

      /pools/default/serverGroups/<:uuid>/addNode

      Adding Nodes to Groups

      PUT

      /pools/default/serverGroups/<:uuid>

      Renaming Groups

      PUT

      /pools/default/serverGroups?rev=<:number>

      Updating Group Membership

      DELETE

      /pools/default/serverGroups/<:uuid>

      Deleting Groups

      XDCR API

      Cross Data Center Replication (XDCR) replicates data between a source bucket and a target bucket. The buckets may be located on different clusters, and in different data centers: this provides protection against data-center failure, and also provides high-performance data-access for globally distributed, mission-critical applications. XDCR is supported by the REST API shown in the table below.

      HTTP Method URI Documented at

      POST

      /pools/default/remoteClusters

      Creating and Editing References

      GET

      /pools/default/remoteClusters

      Getting a Reference

      POST

      /controller/createReplication

      Creating a Replication

      POST

      /settings/replications/[replication_id]

      Pausing and Resuming a Replication

      DELETE

      /controller/cancelXDCR/[url_encoded_replication_id]

      Deleting a Replication

      DELETE

      /pools/default/remoteClusters/[destination-cluster-name]

      Deleting a Reference

      POST

      /settings/replications/

      Managing Advanced Settings

      POST

      /settings/replications/<settings_URI>

      Managing Advanced Settings

      GET

      /settings/replications/

      Managing Advanced Settings

      GET

      /settings/replications/<settings_URI>

      Managing Advanced Settings

      GET

      /pools/default/buckets/[source_bucket]/stats/[destination_endpoint]

      Getting Statistics

      Security API

      The Security REST API provides the endpoints for general security, for authentication, and for authorization. These APIs are listed in the tables below.

      General Security

      HTTP Method URI Documented at

      GET

      ./whoami

      Who Am I?

      GET

      /settings/audit

      Configure Auditing

      POST

      /settings/audit

      Configure Auditing

      GET

      /settings/audit/descriptors

      Configure Auditing

      GET

      /settings/security

      Restrict Node-Addition

      POST

      /settings/security

      Restrict Node-Addition

      POST

      /clusterInit

      Initialize a Cluster

      GET

      /settings/security/[service-name]

      Configure On-the-Wire Security

      POST

      /settings/security/[service-name]

      Configure On-the-Wire Security

      POST

      /node/controller/rotateInternalCredentials

      Rotate Internal Credentials

      GET

      /settings/security/responseHeaders

      Configure HSTS

      POST

      /settings/security/responseHeaders

      Configure HSTS

      DELETE

      /settings/security/responseHeaders

      Configure HSTS

      Authentication

      HTTP Method URI Documented at

      GET

      /settings/ldap

      Configure LDAP

      POST

      /settings/ldap

      Configure LDAP

      GET

      /settings/saml

      Configure SAML

      POST

      /settings/saml

      Configure SAML

      GET

      /settings/saslauthdAuth

      Configure saslauthd

      POST

      /settings/saslauthdAuth

      Configure saslauthd

      GET

      /settings/passwordPolicy

      Set Password Policy

      POST

      /settings/passwordPolicy

      Set Password Policy

      POST

      /controller/changePassword

      Change Password

      POST

      /node/controller/loadTrustedCAs

      Load Root Certificates

      GET

      /node/controller/loadTrustedCAs

      Get Root Certificates

      DELETE

      /pools/default/trustedCAs/<id>

      Delete Root Certificates

      GET

      /pools/default/certificates

      Retrieve All Node Certificates

      POST

      /node/controller/reloadCertificate

      Upload and Retrieve Node Certificates

      GET

      /pools/default/certificate/node/<ip-address-or-domain-name>

      Upload and Retrieve Node Certificates

      POST

      /controller/regenerateCertificate

      Regenerate All Certificates

      Authorization

      HTTP Method URI Documented at

      GET

      /settings/rbac/roles

      List Roles

      GET

      /settings/rbac/users

      List Current Users and Their Roles

      POST

      /pools/default/checkPermissions

      Check Permissions

      GET

      /settings/rbac/groups

      List Currently Defined Groups

      PUT

      /settings/rbac/users/local/<new-username>

      Create a Local User

      PATCH

      /settings/rbac/users/local/<existing-username>

      Create a Local User

      PUT

      /settings/rbac/users/local/<new-username>

      Create an External User

      PUT

      /settings/rbac/groups/<new-groupname>

      Create a Group

      DELETE

      /settings/rbac/users/local/<local-username>

      Delete Users and Groups

      DELETE

      /settings/rbac/users/external/<external-username>

      Delete Users and Groups

      DELETE

      /settings/rbac/groups/<groupname>

      Delete Users and Groups

      System-Secrets Management

      HTTP Method URI Documented at

      GET

      /nodes/self/secretsManagement

      Configuring System Secrets

      POST

      /node/controller/secretsManagement

      Configuring System Secrets

      POST

      /node/controller/changeMasterPassword

      Changing the Master Password

      POST

      /node/controller/rotateDataKey

      Rotating the Data Key

      Query Service API

      The Query Service provides a REST API that covers four requirements; which are the administration of Query Service nodes, the configuration of the Query Service, the execution of SQL++ statements, and the management of JavaScript libraries and objects used to create SQL++ user-defined functions. The REST API is detailed in the tables below.

      SQL++ Statement Execution

      HTTP Method URI Documented at

      POST

      /query/service

      Query Service

      GET

      /query/service

      Read-Only Query Service

      Query Service Administration

      HTTP Method URI Documented at

      GET

      /admin/clusters

      Read All Clusters

      GET

      /admin/clusters/{cluster}

      Read a Cluster

      GET

      /admin/clusters/{cluster}/nodes

      Read All Nodes

      GET

      /admin/clusters/{cluster}/nodes/{node}

      Read a Node

      GET

      /admin/config

      Read Configuration

      GET

      /admin/prepareds

      Retrieve All Prepared Statements

      GET

      /admin/prepareds/{name}

      Retrieve a Prepared Statement

      DELETE

      /admin/prepareds/{name}

      Delete a Prepared Statement

      GET

      /admin/indexes/prepareds

      Retrieve Prepared Index Statements

      GET

      /admin/active_requests

      Retrieve All Active Requests

      GET

      /admin/active_requests/{request}

      Retrieve an Active Request

      DELETE

      /admin/active_requests/{request}

      Delete an Active Request

      GET

      /admin/indexes/active_requests

      Retrieve Active Index Requests

      GET

      /admin/completed_requests

      Retrieve All Completed Requests

      GET

      /admin/completed_requests/{request}

      Retrieve a Completed Request

      DELETE

      /admin/completed_requests/{request}

      Delete a Completed Request

      GET

      /admin/indexes/completed_requests

      Retrieve Completed Index Requests

      GET

      /admin/vitals

      Retrieve Vitals

      GET

      /admin/stats

      Retrieve All Statistics

      GET

      /admin/stats/{stats}

      Retrieve a Statistic

      GET

      /admin/settings

      Retrieve Node-Level Query Settings

      POST

      /admin/settings

      Update Node-Level Query Settings

      GET

      /admin/ping

      Ping

      GET

      /admin/gc

      Run Garbage Collector

      POST

      /admin/gc

      Run Garbage Collector and Release Memory

      Query Service Settings

      HTTP Method URI Documented at

      GET

      /settings/querySettings

      Retrieve Cluster-Level Query Settings

      POST

      /settings/querySettings

      Update Cluster-Level Query Settings

      GET

      /settings/querySettings/curlWhitelist

      Retrieve CURL Access List

      POST

      /settings/querySettings/curlWhitelist

      Update CURL Access List

      JavaScript Management

      HTTP Method URI Documented at

      GET

      /evaluator/v1/libraries

      Read All Libraries

      GET

      /evaluator/v1/libraries/{library}

      Read a Library

      POST

      /evaluator/v1/libraries/{library}

      Create or Update a Library

      DELETE

      /evaluator/v1/libraries/{library}

      Delete a Library

      Index Service API

      The Index Service REST API provides configuration options for the Index Service. The API is listed below.

      HTTP Method URI Documented at

      GET

      /settings/indexes

      Retrieve GSI Settings

      POST

      /settings/indexes

      Set GSI Settings

      GET

      /api/v1/stats

      Get Node Statistics

      GET

      /api/v1/stats/{keyspace}

      Get Keyspace Statistics

      GET

      /api/v1/stats/{keyspace}/{index}

      Get Index Statistics

      Backup Service API

      The Backup Service API supports management of the Backup Service, providing endpoints categorized as follows: Cluster, Configuration, Repository, Plan, Task, and Data. All calls require the Full Admin role, and use port 8097. Each URI, in Couchbase Server Enterprise Edition Version 7.0 and later, must be prefixed with /api/v1.

      The individual endpoints are listed by category, in the tables below.

      Cluster

      HTTP Method URI Documented at

      GET

      /cluster/self

      Get Information on the Cluster

      Configuration

      HTTP Method URI Description

      GET

      /config

      Manage Backup Configuration

      POST

      /config

      Manage Backup Configuration

      PUT

      /config

      Manage Backup Configuration

      Repository

      HTTP Method URI Documented at

      GET

      /cluster/self/repository/<'active'|'archived'|'imported'>

      Get Information on Repositories

      GET

      /cluster/self/repository/active/<repository-id>

      Get Information on Repositories

      GET

      /cluster/self/repository/<'active'|'archived'|'imported'>/<repository-id>/info

      Get Information on Repositories

      POST

      /cluster/self/repository/active/<repository-id>

      Create a Repository

      POST

      /cluster/self/repository/<'archived'|'imported'>/<repository-id>/restore

      Restore Data

      POST

      /cluster/self/repository/import

      Import a Repository

      POST

      /cluster/self/repository/<'active'|'archived'|'imported'>/<repository-id>/examine

      Examine Backed-Up Data

      POST

      /cluster/self/repository/active/<repository-id>/backup

      Perform an Immediate Backup

      POST

      /cluster/self/repository/active/<repository-id>/merge

      Perform an Immediate Merge

      POST

      /cluster/self/repository/active/<repository-id>/archive

      Archive a Repository

      POST

      /cluster/self/repository/active/<repository-id>/pause

      Pause and Resume Tasks

      POST

      /cluster/self/repository/active/<repository-id>/resume

      Pause and Resume Tasks

      DELETE

      /cluster/self/repository/<'archived'|'imported'>/<repository-id>

      Delete a Repository

      DELETE

      /cluster/self/repository/<'archived'|'imported'>/<repository-id>?remove_repository

      Delete a Repository

      DELETE

      /cluster/self/repository/active/<repository-id>/backups/<backup-id>

      Delete a Backup

      Plan

      HTTP Method URI Documented at

      GET

      /cluster/plan

      Get Information on Plans

      GET

      /cluster/plan/<plan-id>

      Get Information on Plans

      POST

      /cluster/plan/<plan-id>

      Create and Edit Plans

      PUT

      /cluster/plan/<existing-plan-id>

      Create and Edit Plans

      DELETE

      /plan/<plan-id>

      Delete a Plan

      Task

      HTTP Method URI Documented at

      GET

      /cluster/self/repository/<'active'|'archived'|'imported'>/<repository-id>/taskHistory

      Get Information on Tasks

      GET

      /cluster/self/repository/<'active'|'archived'|'imported'>/<repository-id>/taskHistory?<task-subset-specification-string>

      Get Information on Tasks

      Data

      HTTP Method URI Documented at

      DELETE

      /cluster/self/repository/active/<repository-id>/backups/<backup-id>

      Delete Backups

      Search Service API

      The Search Service allows users to create, manage, and query Full Text Indexes, whereby searches can be performed and matches attained on character strings. The Search Service REST API allows such indexes to be created and maintained. The API is listed in the tables below.

      Index Definition

      HTTP Method URI Documented at

      GET

      /api/index

      Index Definition

      GET

      /api/index/{indexName}

      Index Definition

      PUT

      /api/index/{indexName}

      Index Definition

      DELETE

      /api/index/{indexName}

      Index Definition

      Index Management

      HTTP Method URI Documented at

      POST

      /api/index/{indexName}/ingestControl/{op}

      Index Management

      POST

      /api/index/{indexName}/planFreezeControl/{op}

      Index Management

      POST

      /api/index/{indexName}/planQueryControl/{op}

      Index Management

      Index Monitoring and Debugging

      HTTP Method URI Documented at

      GET

      /api/stats

      Index Monitoring And Debugging

      GET

      /api/stats/{indexName}

      Index Monitoring And Debugging

      POST

      /api/stats/{indexName}/analyzeDoc

      Index Monitoring And Debugging

      GET

      /api/query/index/{indexName}

      Index Monitoring And Debugging

      Index Querying

      HTTP Method URI Documented at

      GET

      /api/index/{indexName}/count

      Index Querying

      POST

      /api/index/{indexName}/query

      Index Querying

      Node Configuration

      HTTP Method URI Documented at

      GET

      /api/cfg

      Node Configuration

      POST

      /api/cfgRefresh

      Node Configuration

      POST

      /api/managerKick

      Node Configuration

      GET

      /api/managerMeta

      Node Configuration

      Node Diagnostics

      HTTP Method URI Documented at

      GET

      /api/diag

      Node Diagnostics

      GET

      /api/log

      Node Diagnostics

      GET

      /api/runtime

      Node Diagnostics

      GET

      /api/runtime/args

      Node Diagnostics

      POST

      /api/runtime/profile/cpu

      Node Diagnostics

      POST

      /api/runtime/profile/memory

      Node Diagnostics

      Node Management

      HTTP Method URI Documented at

      POST

      /api/runtime/gc

      Node Management

      Node Monitoring

      HTTP Method URI Documented at

      GET

      /api/runtime/stats

      Node Monitoring

      GET

      /api/runtime/stats/statsMem

      Node Monitoring

      Index Partition Definition

      HTTP Method URI Documented at

      GET

      /api/pindex

      Advanced

      GET

      /api/pindex/{pindexName}

      Advanced

      Index Partition Querying

      HTTP Method URI Documented at

      GET

      /api/pindex/{pindexName}/count

      Advanced

      POST

      /api/pindex/{pindexName}/query

      Advanced

      FTS Memory Quota

      HTTP Method URI Documented at

      POST

      /pools/default

      Advanced

      Eventing Service API

      The Eventing Service REST API provides methods for working with Eventing Functions. The complete API is listed at Eventing REST API.

      Analytics Service API

      The Analytics Service provides a REST API for querying, configuration, and the management of links and libraries. The API is listed in the following tables.

      Analytics Query API

      HTTP Method URI Documented at

      POST

      /analytics/service

      Query Service

      GET

      /analytics/service

      Read-Only Query Service

      POST

      /query/service

      Query Service (Alternative)

      GET

      /query/service

      Read-Only Query Service (Alternative)

      Analytics Admin API

      HTTP Method URI Documented at

      DELETE

      /analytics/admin/active_requests

      Request Cancellation

      GET

      /analytics/cluster

      Cluster Status

      POST

      /analytics/cluster/restart

      Cluster Restart

      POST

      /analytics/node/restart

      Node Restart

      GET

      /analytics/status/ingestion

      Ingestion Status

      Analytics Config API

      HTTP Method URI Documented at

      GET

      /analytics/config/service

      View Service-Level Parameters

      PUT

      /analytics/config/service

      Modify Service-Level Parameters

      GET

      /analytics/config/node

      View Node-Specific Parameters

      PUT

      /analytics/config/node

      Modify Node-Specific Parameters

      Analytics Settings API

      HTTP Method URI Documented at

      GET

      /settings/analytics

      View Analytics Settings

      PUT

      /settings/analytics

      Modify Analytics Settings

      HTTP Method URI Documented at

      POST

      /analytics/link/{scope}/{name}

      Create Link

      GET

      /analytics/link/{scope}/{name}

      Query Link

      PUT

      /analytics/link/{scope}/{name}

      Edit Link

      DELETE

      /analytics/link/{scope}/{name}

      Delete Link

      GET

      /analytics/link

      Query All Links

      GET

      /analytics/link/{scope}

      Query Scope Links

      Analytics Library API

      HTTP Method URI Documented at

      GET

      /analytics/library

      Read All Libraries

      POST

      /analytics/library/{scope}/{library}

      Create or Update a Library

      DELETE

      /analytics/library/{scope}/{library}

      Delete a Library

      HTTP Request Headers

      The following HTTP request headers are used to create requests:

      Header Supported Values Description of Use Required

      Accept

      Comma-delimited list of media types or media type patterns.

      Indicates to the server what media type(s) this client is prepared to accept.

      Recommended

      Authorization

      Basic plus username and password (per RFC 2617).

      Identifies the authorized user making this request.

      No, unless secured

      Content-Length

      Body Length (in bytes)

      Describes the size of the message body.

      Yes, on requests that contain a message body.

      Content-Type

      Content type

      Describes the representation and syntax of the request message body.

      Yes, on requests that contain a message body.

      Host

      Origin host name

      Required to allow support of multiple origin hosts at a single IP address.

      All requests

      X-YYYYY-Client-Specification-Version

      String

      Declares the specification version of the YYYYY API that this client was programmed against.

      No

      HTTP Response Codes

      The Couchbase Server returns one of the following HTTP status codes in response to REST API requests:

      HTTP response Description

      200 OK

      Successful request and an HTTP response body returns. If this creates a new resource with a URI, the 200 status will also have a location header containing the canonical URI for the newly created resource.

      201 Created

      Request to create a new resource is successful, but no HTTP response body returns. The URI for the newly created resource returns with the status code.

      202 Accepted

      The request is accepted for processing, but processing is not complete. Per HTTP/1.1, the response, if any, SHOULD include an indication of the request’s current status, and either a pointer to a status monitor or some estimate of when the request will be fulfilled.

      204 No Content

      The server fulfilled the request, but does not need to return a response body.

      400 Bad Request

      The request could not be processed because it contains missing or invalid information, such as validation error on an input field, a missing required value, and so on.

      401 Unauthorized

      The credentials provided with this request are missing or invalid.

      403 Forbidden

      The server recognized the given credentials, but you do not possess proper access to perform this request.

      404 Not Found

      URI provided in a request does not exist.

      405 Method Not Allowed

      The HTTP verb specified in the request (DELETE, GET, HEAD, POST, PUT) is not supported for this URI.

      406 Not Acceptable

      The resource identified by this request cannot create a response corresponding to one of the media types in the Accept header of the request.

      409 Conflict

      A create or update request could not be completed, because it would cause a conflict in the current state of the resources supported by the server. For example, an attempt to create a new resource with a unique identifier already assigned to some existing resource.

      500 Internal Server Error

      The server encountered an unexpected condition which prevented it from fulfilling the request.

      501 Not Implemented

      The server does not currently support the functionality required to fulfill the request.

      503 Service Unavailable

      The server is currently unable to handle the request due to temporary overloading or maintenance of the server.