Dashboard
API
- Overview
- Get started
- How It Works
- Core
- Websets
- Items
- Searches
- Enrichments
- Webhooks
- Events
Update a Webset
curl --request POST \
--url https://api.exa.ai/websets/v0/websets/{id} \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '{
"metadata": {}
}'{
"id": "<string>",
"object": "webset",
"status": "idle",
"externalId": "<string>",
"searches": [
{
"id": "<string>",
"object": "webset_search",
"status": "created",
"query": "<string>",
"entity": {
"type": "company"
},
"criteria": [
{
"description": "<string>",
"successRate": 50
}
],
"count": 2,
"progress": {
"found": 123,
"completion": 50
},
"metadata": {},
"canceledAt": "2023-11-07T05:31:56Z",
"canceledReason": "webset_deleted",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
}
],
"enrichments": [
{
"id": "<string>",
"object": "webset_enrichment",
"status": "pending",
"websetId": "<string>",
"title": "<string>",
"description": "<string>",
"format": "text",
"options": [
{
"label": "<string>"
}
],
"instructions": "<string>",
"metadata": {},
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
}
],
"metadata": {},
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
}Authorizations
Your Exa API key
Path Parameters
The id or externalId of the Webset
Body
Response
The unique identifier for the webset
"webset"The status of the webset
idle, running, paused The external identifier for the webset
The searches that have been performed on the webset.
The unique identifier for the search
"webset_search"The status of the search
created, running, completed, canceled The query used to create the search.
1 - 5000The entity the search will return results for.
When no entity is provided during creation, we will automatically select the best entity based on the query.
"company"The criteria the search will use to evaluate the results. If not provided, we will automatically generate them for you.
The number of results the search will attempt to find. The actual number of results may be less than this number depending on the search complexity.
x >= 1The date and time the search was canceled
The reason the search was canceled
webset_deleted, webset_canceled The date and time the search was created
The date and time the search was updated
The Enrichments to apply to the Webset Items.
The unique identifier for the enrichment
"webset_enrichment"The status of the enrichment
pending, canceled, completed The unique identifier for the Webset this enrichment belongs to.
The title of the enrichment.
This will be automatically generated based on the description and format.
The description of the enrichment task provided during the creation of the enrichment.
The format of the enrichment response.
text, date, number, options, email, phone When the format is options, the different options for the enrichment agent to choose from.
The label of the option
The instructions for the enrichment Agent.
This will be automatically generated based on the description and format.
The date and time the enrichment was created
The date and time the enrichment was updated
The date and time the webset was created
The date and time the webset was updated
curl --request POST \
--url https://api.exa.ai/websets/v0/websets/{id} \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '{
"metadata": {}
}'{
"id": "<string>",
"object": "webset",
"status": "idle",
"externalId": "<string>",
"searches": [
{
"id": "<string>",
"object": "webset_search",
"status": "created",
"query": "<string>",
"entity": {
"type": "company"
},
"criteria": [
{
"description": "<string>",
"successRate": 50
}
],
"count": 2,
"progress": {
"found": 123,
"completion": 50
},
"metadata": {},
"canceledAt": "2023-11-07T05:31:56Z",
"canceledReason": "webset_deleted",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
}
],
"enrichments": [
{
"id": "<string>",
"object": "webset_enrichment",
"status": "pending",
"websetId": "<string>",
"title": "<string>",
"description": "<string>",
"format": "text",
"options": [
{
"label": "<string>"
}
],
"instructions": "<string>",
"metadata": {},
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
}
],
"metadata": {},
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
}