---
title: "Add vertex collection"
method: POST
path: "/_fabric/{fabric}/_api/graph/{graph}/vertex"
tags: ["Graphs"]
---

# Add vertex collection

`POST /_fabric/{fabric}/_api/graph/{graph}/vertex`

## Request

- The document declares no server URL.
- Auth: one of:
  - API key in header `Authorization`
  - HTTP bearer
- TypeScript: <https://skmtc.dev/macrometa/apis/macrometa-api-reference/docs/_fabric/:fabric/_api/graph/:graph/vertex/post.ts> (a function with typed inputs; its response is checked against the schema)

Adds a vertex collection to the set of orphan collections of the graph. If the collection does not exist, it is created.

**Note:** Requires *Administrator* permissions to access the GeoFabric and *Read Only* access on every collection used within this graph.

## Path parameters

- `fabric` string, string, required
- `graph` string, string, required

## Response `201`

Successfully created the vertex collection when *waitForSync* is enabled.

- GraphVertexCollectionAddHttpExamplesRc201
  - `code` integer: HTTP response code.
  - `error` boolean, required: Flag if there is an error in response. *False* for this response.
  - `graph` GraphRepresentation: The information about the newly created graph.
    - `_id` string: The internal id value of this graph.
    - `_key` string: The key of this graph.
    - `_rev` string: The revision of this graph. Can be used to make sure to not override concurrent modifications to this graph.
    - `edgedefinitions` GraphEdgeDefinition[]: An array of definitions for the relations of the graph.
      - `collection` string: Name of the edge collection, where the edge are stored in.
      - `from` string[]: List of vertex collection names. Edges in collection can only be inserted if their _from is in any of the collections here.
      - `to` string[]: List of vertex collection names. Edges in collection can only be inserted if their _to is in any of the collections here.
    - `name` string: The name of the graph.
    - `orphanCollections` string[]: An array of additional vertex collections. Documents within these collections do not have edges within this graph.

## Other responses

- `202`: Successfully created the vertex collection when *waitForSync* is disabled.
- `400`: Failed due to missing or malformed data. Verify that all parameters are complete.
- `403`: Failed to validate because you do not have access to the server.
- `404`: Failed to find specified graph.

---

[API](https://skmtc.dev/macrometa/apis/macrometa-api-reference.md) - [All operations](https://skmtc.dev/macrometa/apis/macrometa-api-reference/llms.txt) - [OpenAPI document](https://skmtc.dev/macrometa/apis/macrometa-api-reference/revisions/2006b6d7f31d?raw)