Create a Global Config

POST https://api.vercel.com/v1/global-config

Creates a Global Config.

Request Example

const response = await fetch('https://api.vercel.com/v1/global-config?teamId=string&slug=string', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "slug": "string",
    "items": "value"
  }),
});

const data = await response.json();
console.log(data);

Response Example

{
  "createdAt": "123",
  "createdBy": "string",
  "deletedAt": "123",
  "digest": "string",
  "id": "icfg_1234567890",
  "ownerId": "example_id",
  "purpose": {
    "projectId": "example_id",
    "type": "flags"
  },
  "schema": "value",
  "slug": "string",
  "syncedToDynamoAt": "123",
  "transfer": {
    "doneAt": "123",
    "fromAccountId": "example_id",
    "startedAt": "123"
  },
  "updatedAt": "123",
  "itemCount": "123",
  "sizeInBytes": "123"
}

Authentication

Authorization

Bearer Token

Default authentication mechanism.

Query Parameters

• teamId: string (Optional) - The Team identifier to perform the request on behalf of.
• slug: string (Optional) - The Team slug to perform the request on behalf of.

Body

• slug: string (Required) - Name for the Global Config (Names are not unique and must start with an alphabetic character and can contain only alphanumeric characters and underscores).
• items: object (Optional)

Response

201 Success

Response Fields

• createdAt: number (Required)
• createdBy: string (Optional) - The ID of the user who created the Global Config, optional because it is not always set.
• deletedAt: number (Optional)
• digest: string (Required)
• id: string (Required)
• ownerId: string (Required)
• purpose: object (Optional)
• schema: object (Optional)
• slug: string (Required)
• syncedToDynamoAt: number (Optional)
• transfer: object (Optional) - Keeps track of the current state of the Global Config while it gets transferred.
• updatedAt: number (Required)
• itemCount: number (Required)
• sizeInBytes: number (Required)

Errors

• 400: One of the provided values in the request body is invalid.
• 401: The request is not authorized.
• 402: The account is missing a payment so the payment method must be updated.
• 403: You do not have permission to access this resource.