---
title: "Create enrichment table from URL"
method: POST
path: "/api/{org_id}/enrichment_tables/{table_name}/url"
tags: ["Functions"]
---

# Create enrichment table from URL

`POST /api/{org_id}/enrichment_tables/{table_name}/url`

## Request

- Base URL: `https://api.openobserve.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.openobserve.ai/api/{org_id}/enrichment_tables/{table_name}/url`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/openobserve/apis/openobserve-api-http/docs/api/:org_id/enrichment_tables/:table_name/url/post.ts> (a function with typed inputs; its response is checked against the schema)

Creates a new enrichment table by fetching CSV data from a public URL. The process runs asynchronously in the background.

## Path parameters

- `org_id` string, required
- `table_name` string, required

## Query parameters

- `append` boolean

## Request body

- EnrichmentTableUrlRequest: Request body for creating an enrichment table from a public URL. The URL must point to a publicly accessible CSV file. Authentication-required URLs (e.g., S3 presigned URLs with complex headers) are not currently supported. The `append` behavior is controlled via query parameter, matching the file upload endpoint.
  - `replace_failed` boolean: Replace only the failed job's URL (optional, default: false) When true, only updates the failed job with the new URL while keeping all successful jobs unchanged. Useful for fixing typos or broken URLs without re-downloading working data sources.
  - `url` string, required: Public URL to the CSV file. Requirements: - Must start with http:// or https:// - Must be publicly accessible (no authentication) - Should return CSV content-type (not enforced but recommended) - File can be any size - streaming handles large files efficiently

## Response `202`

Job created successfully

## Other responses

- `400`: Bad Request
- `500`: Internal Server Error

---

[API](https://skmtc.dev/openobserve/apis/openobserve-api-http.md) - [All operations](https://skmtc.dev/openobserve/apis/openobserve-api-http/llms.txt) - [OpenAPI document](https://skmtc.dev/openobserve/apis/openobserve-api-http/revisions/0529b8a10252?raw)