POST /namespaces

Create a namespace in a serverless index.

For guidance and examples, see Manage namespaces.

Note: This operation is not supported for pod-based indexes.

Servers

Request headers

Name Type Required Description
Content-Type String Yes The media type of the request body.

Default value: "application/json"

X-Pinecone-Api-Version String Yes

Required date-based version header

Default value: "2025-10"

Request body fields

Name Type Required Description
name String Yes

The name of the namespace.

schema Object No

Schema for the behavior of Pinecone's internal metadata index. By default, all metadata is indexed; when schema is present, only fields which are present in the fields object with a filterable: true are indexed. Note that filterable: false is not currently supported.

schema.fields Object Yes

A map of metadata field names to their configuration. The field name must be a valid metadata field name. The field name must be unique.

schema.fields.name Object No
schema.fields.name.filterable Boolean No

Whether the field is filterable. If true, the field is indexed and can be used in filters. Only true values are allowed.

How to start integrating

  1. Add HTTP Task to your workflow definition.
  2. Search for the API you want to integrate with and click on the name.
    • This loads the API reference documentation and prepares the Http request settings.
  3. Click Test request to test run your request to the API and see the API's response.