> ## Documentation Index > Fetch the complete documentation index at: https://docs.exec.com/llms.txt > Use this file to discover all available pages before exploring further. # Create source > Creates a Knowledge Hub source from a URL. Text extraction runs asynchronously, so the source is returned with `status: pending` or `processing`; poll the detail endpoint until `status` is `ready`. URL sources are de-duplicated within the workspace: if the URL already exists, the existing source is returned with status `200` instead of `201`. > File upload via the REST API is not yet supported — use URL ingest. ## OpenAPI ````yaml /api-reference/openapi.yaml post /knowledge-hub/sources openapi: 3.0.3 info: title: Exec API version: '1.0' description: > REST API for programmatic access to your Exec workspace. Use the Exec API to read workspace data, list members, retrieve group information, and create interactive scenario creation sessions. ## Authentication All requests require a valid API key passed in the Authorization header: ``` Authorization: Bearer exec_live_... ``` Create API keys in your workspace settings under **Settings > API**. servers: - url: https://api.exec.com/rest/v1 description: Production security: - bearerAuth: [] paths: /knowledge-hub/sources: post: tags: - Knowledge Hub - Sources summary: Create source description: | Creates a Knowledge Hub source from a URL. Text extraction runs asynchronously, so the source is returned with `status: pending` or `processing`; poll the detail endpoint until `status` is `ready`. URL sources are de-duplicated within the workspace: if the URL already exists, the existing source is returned with status `200` instead of `201`. > File upload via the REST API is not yet supported — use URL ingest. operationId: createKnowledgeHubSource requestBody: required: true content: application/json: schema: type: object required: - type - title properties: type: type: string enum: - url description: Source type. Only `url` is supported via the REST API today. title: type: string description: Display title for the source url: type: string format: uri description: The URL to ingest (required when `type` is `url`) cover: type: string description: Optional cover image reference folder_ids: type: array items: type: string description: UUIDs of folders to place the source in example: type: url title: Competitor pricing page url: https://example.com/pricing folder_ids: - f1a2b3c4d5e6 responses: '200': description: An existing source with the same URL was returned (de-duplicated) content: application/json: schema: $ref: '#/components/schemas/KnowledgeHubSource' '201': description: Source created; extraction queued content: application/json: schema: $ref: '#/components/schemas/KnowledgeHubSource' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' components: schemas: KnowledgeHubSource: type: object description: >- A Knowledge Hub source — an uploaded file or ingested URL whose text is extracted and indexed. properties: id: type: string description: Unique source identifier (UUID) title: type: string description: Source title source_type: type: string enum: - upload - url - notion - google_drive - guru - page - integration description: Where the source came from status: type: string enum: - pending - processing - ready - failed description: Text-extraction status content_format: type: string nullable: true enum: - markdown - plain_text - image - video description: Format of the extracted content token_count: type: integer nullable: true description: Number of tokens in the extracted text has_images: type: boolean description: Whether the source contains images external_url: type: string nullable: true description: >- Original URL for url/notion/guru/google_drive sources (null otherwise) summary: type: string nullable: true description: AI-generated summary of the source cover: type: string description: Cover image reference (empty string if none) folders: type: array description: Folders the source belongs to items: $ref: '#/components/schemas/KnowledgeHubFolderRef' created_by: $ref: '#/components/schemas/User' nullable: true description: User who added the source created_at: type: string format: date-time updated_at: type: string format: date-time processed_at: type: string format: date-time nullable: true description: When extraction finished content: type: string nullable: true description: Extracted text (only included when requested via `?include=content`) KnowledgeHubFolderRef: type: object description: A compact folder reference embedded in pages and sources. properties: id: type: string description: Unique folder identifier (UUID) name: type: string description: Folder name emoji: type: string nullable: true description: Emoji icon shown next to the folder User: type: object properties: id: type: string description: Unique user identifier email: type: string format: email description: User's email address first_name: type: string description: User's first name last_name: type: string description: User's last name ValidationErrorDetail: type: object properties: error: type: object properties: type: type: string description: Error category (e.g., "invalid_request") code: type: string description: Specific error code (e.g., "user_not_found") message: type: string description: Human-readable error message responses: BadRequest: description: Invalid request parameters content: application/json: schema: $ref: '#/components/schemas/ValidationErrorDetail' example: error: type: invalid_request code: invalid_pagination message: Invalid pagination parameters Unauthorized: description: Missing or invalid API key content: application/json: schema: $ref: '#/components/schemas/ValidationErrorDetail' example: error: type: authentication_error code: invalid_api_key message: Invalid or inactive API key securitySchemes: bearerAuth: type: http scheme: bearer description: | API key created in Settings > API. Format: `exec_live_` followed by 40 alphanumeric characters. ````