---
title: "Create content"
method: POST
path: "/orgs/knowledge/contents"
tags: ["Knowledge"]
---

# Create content

`POST /orgs/knowledge/contents`

## Request

- Base URL: `https://api.useinvent.com`
- URL: `https://api.useinvent.com/orgs/knowledge/contents`
- Auth: HTTP bearer

Create a new content for the organization.

## Request body

- CreateVectorContentSchema: Schema for creating a vector
  - `title` string
  - `content` union, required: Content configuration schema for different vector input types
    - VectorContentTextConfigSchema
      - `type` 'TEXT', required
      - `text` string
    - VectorContentFileConfigSchema
      - `type` 'FILE', required
      - `file` FileSchema, required: Detailed information about a file
        - `id` string, required: Unique identifier for the file
        - `file_path` string, required: Path to the file in the storage system
        - `file_filename` string, required: Name of the file
        - `file_size` number, required: Size of the file in bytes
        - `file_mimetype` string, required: MIME type of the file
        - `file_url` string, required: URL to access the file
        - `created_at` string, date-time, nullable, required: Timestamp when the file was created
    - VectorContentUrlConfigSchema
      - `type` 'URL', required
      - `mode` 'CRAWL' | 'SINGLE_URL', required: Mode of URL content processing
      - `url` string, required
      - `include_path_patterns` string[]: URL content, crawl only: only follow paths matching these (e.g. '/docs/*').
      - `exclude_path_patterns` string[]: URL content, crawl only: skip paths matching these (e.g. '/admin/*').

## Response `200`

The created content.

- VectorContentLimitedSchema: Schema for vector content
  - `id` string, required
  - `title` string, required: Title of the vector
  - `type` 'TEXT' | 'FILE' | 'URL', required: Type of the vector content
  - `content` union, required: Content configuration schema for different vector input types
    - VectorContentTextConfigSchema
      - `type` 'TEXT', required
      - `text` string
    - VectorContentFileConfigSchema
      - `type` 'FILE', required
      - `file` FileSchema, required: Detailed information about a file
        - `id` string, required: Unique identifier for the file
        - `file_path` string, required: Path to the file in the storage system
        - `file_filename` string, required: Name of the file
        - `file_size` number, required: Size of the file in bytes
        - `file_mimetype` string, required: MIME type of the file
        - `file_url` string, required: URL to access the file
        - `created_at` string, date-time, nullable, required: Timestamp when the file was created
    - VectorContentUrlConfigSchema
      - `type` 'URL', required
      - `mode` 'CRAWL' | 'SINGLE_URL', required: Mode of URL content processing
      - `url` string, required
      - `include_path_patterns` string[]: URL content, crawl only: only follow paths matching these (e.g. '/docs/*').
      - `exclude_path_patterns` string[]: URL content, crawl only: skip paths matching these (e.g. '/admin/*').
  - `parent_content_id` string: Parent content ID
  - `size` number, required: Size of the vector in bytes
  - `chunks_processed` number, required: Number of chunks processed for the vector
  - `chunks_count` number, required: Number of chunks in the vector
  - `children` VectorContentChildSchema[]: Children (for URL crawl parents)
    - `id` string, required
    - `status` 'PENDING' | 'PROCESSING' | 'PROCESSED' | 'FAILED', required: Status of vector processing
    - `title` string, required: Title of the child content
    - `content` union, required: Content configuration schema for different vector input types
      - VectorContentTextConfigSchema
        - `type` 'TEXT', required
        - `text` string
      - VectorContentFileConfigSchema
        - `type` 'FILE', required
        - `file` FileSchema, required: Detailed information about a file
          - `id` string, required: Unique identifier for the file
          - `file_path` string, required: Path to the file in the storage system
          - `file_filename` string, required: Name of the file
          - `file_size` number, required: Size of the file in bytes
          - `file_mimetype` string, required: MIME type of the file
          - `file_url` string, required: URL to access the file
          - `created_at` string, date-time, nullable, required: Timestamp when the file was created
      - VectorContentUrlConfigSchema
        - `type` 'URL', required
        - `mode` 'CRAWL' | 'SINGLE_URL', required: Mode of URL content processing
        - `url` string, required
        - `include_path_patterns` string[]: URL content, crawl only: only follow paths matching these (e.g. '/docs/*').
        - `exclude_path_patterns` string[]: URL content, crawl only: skip paths matching these (e.g. '/admin/*').
    - `parent_content_id` string: Parent content ID
    - `size` number, required: Size of the vector in bytes
    - `chunks_processed` number, required: Number of chunks processed for the vector
    - `chunks_count` number, required: Number of chunks in the vector
    - `error` string, nullable, required: Error message if vector processing failed
    - `created_at` string, date-time, nullable, required
    - `updated_at` string, date-time, nullable, required
  - `error` string, nullable, required: Error message if vector processing failed
  - `status` 'PENDING' | 'PROCESSING' | 'PROCESSED' | 'FAILED', required: Status of vector processing
  - `created_at` string, date-time, nullable, required
  - `updated_at` string, date-time, nullable, required

---

[API](https://skmtc.dev/useinvent/apis/invent-api.md) · [All operations](https://skmtc.dev/useinvent/apis/invent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/useinvent/apis/invent-api/revisions/98824f3fde82?raw)