Skip to main content
POST
/
v1
/
scouting
/
tasks
curl --request POST \
  --url https://api.yutori.com/v1/scouting/tasks \
  --header 'X-API-Key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "query": "Tell me about the latest news, product updates, press releases, social media announcements, investments into, or other relevant information about Yutori"
  }'

{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "query": "<string>",
  "display_name": "<string>",
  "next_run_timestamp": "2023-11-07T05:31:56Z",
  "user_timezone": "<string>",
  "next_output_timestamp": "2023-11-07T05:31:56Z",
  "created_at": "2023-11-07T05:31:56Z",
  "completed_at": "2023-11-07T05:31:56Z",
  "paused_at": "2023-11-07T05:31:56Z",
  "query_object": {},
  "is_public": true,
  "view_url": "<string>",
  "webhook_url": "<string>"
}
curl --request POST \
  --url https://api.yutori.com/v1/scouting/tasks \
  --header 'X-API-Key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "query": "Tell me about the latest news, product updates, press releases, social media announcements, investments into, or other relevant information about Yutori"
  }'

​
Advanced Example

Configure recurring monitoring with custom intervals, webhook notifications, and structured JSON output.
curl --request POST \
  --url https://api.yutori.com/v1/scouting/tasks \
  --header 'X-API-Key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "query": "Tell me about the latest news, product updates, press releases, social media announcements, investments into, or other relevant information about Yutori",
    "output_interval": 86400,
    "user_timezone": "America/Los_Angeles",
    "skip_email": true,
    "webhook_url": "https://example.com/webhook",
    "task_spec": {
      "output_schema": {
        "type": "json",
        "json_schema": {
          "type": "object",
          "properties": {
            "stories": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "headline": { "type": "string" },
                  "summary": { "type": "string" },
                  "source_url": { "type": "string" }
                },
                "required": ["headline", "source_url"]
              }
            }
          },
          "required": ["stories"]
        }
      }
    }
  }'

Authorizations

​
x-api-key
string
header
required

Body

application/json
​
query
string
required
String describing what to monitor in natural language.
    This is typically what a user types into the Scouts web UI (without any frequency preferences).
Example:

"Tell me about the latest news, product updates, press releases, social media announcements, investments into, or other relevant information about Yutori, the AI company."

​
output_interval
integer
default:86400
Interval in seconds of how often to run the task. This must be >= 1800 (= 30 minutes).
    On the web UI, this is inferred from what the user types into the new scout input (e.g. "daily at 9am").
    Recommended: 86400 (daily) or 3600 (hourly).
Example:

3600

​
start_timestamp
integer
default:0
Unix timestamp (past, present, or future) of when the scout should start running.
    If past, present, or up to 30 min in the future, the scout will start running immediately.
    Else, the scout will start running at the specified timestamp.
Example:

0

​
user_timezone
string
default:America/Los_Angeles
String indicating the user's timezone (e.g. "America/Los_Angeles")
    On the web UI, this is inferred from the browser's timezone.
    Default: "America/Los_Angeles".
Example:

"America/Los_Angeles"

​
user_location
string | null
default:San Francisco, CA, US
String indicating the user's coarse location in the format: city, region_code, country_name.
    On the web UI, this is inferred from the browser's location.
    Default: "San Francisco, CA, US".
Example:

"San Francisco, CA, US"

​
task_spec
TaskSpec · object

Task specification with JSON output schema for structured updates

Example:
{
  "output_schema": {
    "json_schema": {
      "properties": {
        "stories": {
          "items": {
            "properties": {
              "news": {
                "description": "1 sentence update",
                "type": "string"
              },
              "source": {
                "description": "URL for more details",
                "type": "string"
              }
            },
            "required": ["news", "source"],
            "type": "object"
          },
          "type": "array"
        }
      },
      "required": ["stories"],
      "type": "object"
    },
    "type": "json"
  }
}
​
skip_email
boolean
default:false
If true, email notifications will be skipped and only webhook notifications will be sent.
    Email subscriptions will still be stored but no emails will be sent.
    Default: false (sends both emails and webhooks).
Example:

false

​
webhook_url
string | null

Optional webhook URL to receive updates for this scout. Creates a webhook subscription for the calling user using webhook_format.

Example:

null

​
webhook_format
enum<string>
default:scout

Webhook payload format to use when webhook_url is provided. Slack incoming webhook URLs require 'slack'.

Available options:
scout,
slack,
zapier
Example:

"scout"

​
is_public
boolean
default:false
Whether the scout is publicly accessible (true) or private (false).
    Public scouts can be accessed by anyone via the UUID link.
    Private scouts can only be accessed by the creator.

Response

Successful Response

Public API response for scout creation. Excludes internal fields like llm_output.

​
id
string<uuid>
required
​
query
string
required
​
display_name
string
required
​
next_run_timestamp
string<date-time> | null
required
​
user_timezone
string
required
​
next_output_timestamp
string<date-time> | null
required
​
created_at
string<date-time>
required
​
completed_at
string<date-time> | null
required
​
paused_at
string<date-time> | null
required
​
query_object
Query Object · object
​
is_public
boolean
default:true
​
view_url
string | null

URL to view this scout's details in the API platform dashboard.

​
webhook_url
string | null

Optional webhook URL configured for this scout, if provided at creation time.