Skip to main content
PATCH
https://agent.usedari.com
/
portals
/
{org_id}
/
{endpoint_name}
curl -X PATCH https://agent.usedari.com/portals/my-org/insurance_quote \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "start_url": "https://example.com/new-quote",
    "task": "Fill out the updated insurance quote form"
  }'
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "org_id": "my-org",
  "endpoint_name": "insurance_quote",
  "start_url": "https://example.com/new-quote",
  "task": "Fill out the updated insurance quote form",
  "form_schema": { "type": "object", "properties": {} },
  "output_schema": null,
  "profile_id": null,
  "humanized_urls": null,
  "webhook_url": null,
  "skills": [],
  "created_at": "2025-01-15T10:30:00Z",
  "updated_at": "2025-01-16T09:00:00Z"
}
Updates a portal’s configuration. Only provided fields are updated.

Path Parameters

org_id
string
required
Organization ID
endpoint_name
string
required
Portal endpoint name

Headers

X-API-Key
string
required
Organization API key

Request Body

All fields are optional. Only provided fields are updated.
start_url
string
Updated starting URL
task
string
Updated task description
form_schema
object
Updated input JSON Schema
output_schema
object
Updated output JSON Schema
profile_id
string
Updated browser profile UUID
skill_ids
string[]
Updated skill UUIDs (replaces existing)
humanized_urls
string[]
Updated humanized URLs
webhook_url
string
URL to receive webhook notifications when jobs complete or fail. Set to null to disable.
curl -X PATCH https://agent.usedari.com/portals/my-org/insurance_quote \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "start_url": "https://example.com/new-quote",
    "task": "Fill out the updated insurance quote form"
  }'
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "org_id": "my-org",
  "endpoint_name": "insurance_quote",
  "start_url": "https://example.com/new-quote",
  "task": "Fill out the updated insurance quote form",
  "form_schema": { "type": "object", "properties": {} },
  "output_schema": null,
  "profile_id": null,
  "humanized_urls": null,
  "webhook_url": null,
  "skills": [],
  "created_at": "2025-01-15T10:30:00Z",
  "updated_at": "2025-01-16T09:00:00Z"
}