--- title: "POST /harvest/source/{ident}/run" method: POST path: "/harvest/source/{ident}/run" tags: ["harvest"] --- # POST /harvest/source/{ident}/run `POST /harvest/source/{ident}/run` ## Request - Base URL: `https://data.public.lu/api/1` - URL: `https://data.public.lu/api/1/harvest/source/{ident}/run` - Auth: none declared ## Headers - `X-Fields` string, mask ## Response `200` Success - HarvestSource - `active` boolean, required: Is this source active - `autoarchive` boolean, required: If enabled, datasets not present on the remote source will be automatically archived - `backend` string, required: The source backend - `config` object: The configuration as key-value pairs - `created_at` string, date-time, required: The source creation date - `deleted` string, date-time: The source deletion date - `description` string, markdown: The source description - `id` string: The source unique identifier - `last_job` HarvestJob - `created` string, date-time, required: The job creation date - `ended` string, date-time: The job end date - `errors` HarvestError[]: The job initialization errors - `level` string, required - `message` string, required - `id` string, required: The job execution ID - `items` HarvestItem[]: The job collected items - `args` string[]: The item positional arguments - `created` string, date-time, required: The item creation date - `dataservice` DataserviceRead - `acronym` string - `archived_at` string, date-time - `authorization_request_url` string - `availability` number - `base_api_url` string - `contact_point` ContactPoint - `email` string, required: The contact point's email - `id` string: The contact point's identifier - `name` string, required: The contact point's name - `organization` OrganizationReference - `class` string, required: The object class - `id` string, required: The object unique identifier - `acronym` string: The organization acronym - `badges` Badge[]: The organization badges - … - `logo` string: The organization logo URL - `logo_thumbnail` string: The organization logo thumbnail URL. This is the square (100x100) and cropped version. - `name` string: The organization name - `page` string: The organization web page URL - `slug` string, required: The organization string used as permalink - `uri` string: The organization API URI - `owner` UserReference - `class` string, required: The object class - `id` string, required: The object unique identifier - `avatar` string: The user avatar URL - `avatar_thumbnail` string: The user avatar thumbnail URL. This is the square (500x500) and cropped version. - `first_name` string: The user first name - `last_name` string: The user larst name - `page` string: The user profile page URL - `slug` string, required: The user permalink string - `uri` string, required: The user API URI - `created_at` string, date-time, required - `datasets` object: Visit this API link to see the list. - `deleted_at` string, date-time - `description` string: In markdown - `endpoint_description_url` string - `extras` object - `format` 'REST' | 'WMS' | 'WSL' - `harvest` HarvestMetadataRead - `archived_at` string, date-time - `backend` string - `created_at` string, date-time: Date of the creation as provided by the harvested catalog - `domain` string - `id` string, required - `last_update` string, date-time: Date of the last harvesting - `remote_id` string - `remote_url` string - `source_id` string - `source_url` string - `uri` string: RDF node ID if it's an `URIRef`. `None` if it's not present or if it's a random auto-generated ID inside the graph. - `has_token` boolean - `id` string, required - `is_restricted` boolean - `license` string: The ID of the license - `metadata_modified_at` string, date-time, required - `metrics` object - `organization` OrganizationReference - `class` string, required: The object class - `id` string, required: The object unique identifier - `acronym` string: The organization acronym - `badges` Badge[]: The organization badges - `kind` string, required: Kind of badge (certified, etc), specific to each model - `logo` string: The organization logo URL - `logo_thumbnail` string: The organization logo thumbnail URL. This is the square (100x100) and cropped version. - `name` string: The organization name - `page` string: The organization web page URL - `slug` string, required: The organization string used as permalink - `uri` string: The organization API URI - `owner` UserReference - `class` string, required: The object class - `id` string, required: The object unique identifier - `avatar` string: The user avatar URL - `avatar_thumbnail` string: The user avatar thumbnail URL. This is the square (500x500) and cropped version. - `first_name` string: The user first name - `last_name` string: The user larst name - `page` string: The user profile page URL - `slug` string, required: The user permalink string - `uri` string, required: The user API URI - `private` boolean: Is the dataservice private to the owner or the organization - `rate_limiting` string - `self_api_url` string: Link to the API endpoint for this dataservice - `self_web_url` string: Link to the udata web page for this dataservice - `slug` string, required - `tags` string[] - `title` string, required - `dataset` DatasetReference - `class` string, required: The object class - `id` string, required: The object unique identifier - `acronym` string: An optional dataset acronym - `page` string: The web page URL for this dataset - `title` string: The dataset title - `uri` string: The API URI for this dataset - `ended` string, date-time: The item end date - `errors` HarvestError[]: The item errors - `level` string, required - `message` string, required - `kwargs` object: The item keyword arguments - `logs` HarvestError[]: The item logs - `level` string, required - `message` string, required - `remote_id` string, required: The item remote ID to process - `started` string, date-time: The item start date - `status` 'pending' | 'started' | 'done' | 'failed' | 'skipped' | 'archived', required: The item status - `source` string, required: The source owning the job - `started` string, date-time: The job start date - `status` 'pending' | 'initializing' | 'initialized' | 'processing' | 'done' | 'done-errors' | 'failed', required: The job status - `name` string, required: The source display name - `organization` OrganizationReference - `class` string, required: The object class - `id` string, required: The object unique identifier - `acronym` string: The organization acronym - `badges` Badge[]: The organization badges - `kind` string, required: Kind of badge (certified, etc), specific to each model - `logo` string: The organization logo URL - `logo_thumbnail` string: The organization logo thumbnail URL. This is the square (100x100) and cropped version. - `name` string: The organization name - `page` string: The organization web page URL - `slug` string, required: The organization string used as permalink - `uri` string: The organization API URI - `owner` UserReference - `class` string, required: The object class - `id` string, required: The object unique identifier - `avatar` string: The user avatar URL - `avatar_thumbnail` string: The user avatar thumbnail URL. This is the square (500x500) and cropped version. - `first_name` string: The user first name - `last_name` string: The user larst name - `page` string: The user profile page URL - `slug` string, required: The user permalink string - `uri` string, required: The user API URI - `schedule` string: The source schedule (interval or cron expression) - `url` string, required: The source base URL - `validation` HarvestSourceValidation - `by` UserReference - `class` string, required: The object class - `id` string, required: The object unique identifier - `avatar` string: The user avatar URL - `avatar_thumbnail` string: The user avatar thumbnail URL. This is the square (500x500) and cropped version. - `first_name` string: The user first name - `last_name` string: The user larst name - `page` string: The user profile page URL - `slug` string, required: The user permalink string - `uri` string, required: The user API URI - `comment` string: A comment about the validation. Required on rejection - `on` string, date-time: Date date on which validation was performed - `state` 'pending' | 'accepted' | 'refused', required: Is it validated or not --- [API](https://skmtc.dev/public/apis/udata-api.md) - [All operations](https://skmtc.dev/public/apis/udata-api/llms.txt) - [OpenAPI document](https://skmtc.dev/public/apis/udata-api/revisions/3f583ca74f7e?raw)