> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bedrock.quarry-systems.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Resources (Batch)

> Create multiple resources in a single request

## Overview

Batch creation allows you to create multiple resources in a single API call.

<Info>
  **ID Format**: All IDs use a namespaced UUIDv7 format: `resource_{uuidv7}`.
</Info>

## Request Body

Array of resource objects:

<ParamField body="[].id" type="string">
  Optional client-provided ID
</ParamField>

<ParamField body="[].resourceTypeId" type="string" required>
  ID of the resource type
</ParamField>

<ParamField body="[].scopeId" type="string" required>
  ID of the owning scope
</ParamField>

<ParamField body="[].externalResourceId" type="string" required>
  External identifier for the resource
</ParamField>

<ParamField body="[].displayName" type="string">
  Display name for the resource
</ParamField>

## Response

Returns an array of created resource objects.

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST 'https://api.example.com/resources/batch' \
    -H 'Authorization: Bearer YOUR_TOKEN' \
    -H 'Content-Type: application/json' \
    -d '[
      {
        "resourceTypeId": "resource_type_document",
        "scopeId": "scope_engineering",
        "externalResourceId": "doc-123",
        "displayName": "Project Roadmap"
      },
      {
        "resourceTypeId": "resource_type_document",
        "scopeId": "scope_engineering",
        "externalResourceId": "doc-456",
        "displayName": "API Specification"
      }
    ]'
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  [
    {
      "id": "resource_0190a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b",
      "resourceTypeId": "resource_type_document",
      "scopeId": "scope_engineering",
      "externalResourceId": "doc-123",
      "displayName": "Project Roadmap",
      "createdAt": "2024-01-15T10:30:00Z",
      "createdBy": "system"
    },
    {
      "id": "resource_0190a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5c",
      "resourceTypeId": "resource_type_document",
      "scopeId": "scope_engineering",
      "externalResourceId": "doc-456",
      "displayName": "API Specification",
      "createdAt": "2024-01-15T10:30:00Z",
      "createdBy": "system"
    }
  ]
  ```
</ResponseExample>