Skip to content
UltimateTeam.ai Docs

Revise Venture

POST
/api/v1/ventures/{venture_id}/feedback
curl --request POST \
  --url https://api.ultimateteam.ai/api/v1/ventures/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/feedback \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <X-API-Key>' \
  --data '{ "feedback": "example", "version": 1 }'

Authorizations

Section titled “Authorizations”

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters”
venture_id
required
Venture Id
string format: uuid

Request Bodyrequired

Section titled “Request Bodyrequired”
Media typeapplication/json
FeedbackRequest
object
feedback
required
Feedback
string
>= 1 characters <= 6000 characters
version
required
Version
integer
>= 1
Examplegenerated
{
  "feedback": "example",
  "version": 1
}

Responses

Section titled “ Responses ”

200

Section titled “200”

Successful Response

Media typeapplication/json
VentureResponse
object
constraints
required
Constraints
string
created_at
required
Created At
string format: date-time
current_version
required
Current Version
integer
economics
Any of:
VentureEconomics
object
collected_cents
required
Any of:
integer
cost_recorded_task_count
required
Cost Recorded Task Count
integer
currency
Currency
string
default: usd
Allowed value: usd
execution_task_count
required
Execution Task Count
integer
full_profit_cents
Full Profit Cents
null
limitations
required
Limitations
Array<string>
live_orders
required
Live Orders
integer
measurement_basis
Measurement Basis
string
default: observed_live_receipts_partial_costs
Allowed value: observed_live_receipts_partial_costs
net_receipts_cents
required
Any of:
integer
processor_fees_cents
required
Any of:
integer
recorded_execution_cost_usd
required
Any of:
string
/^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$/
refunded_cents
required
Any of:
integer
roi_ratio
Roi Ratio
null
test_orders
required
Test Orders
integer
unverified_orders
required
Unverified Orders
integer
id
required
Id
string format: uuid
idea
required
Idea
string
orders
Orders
Array<object>
VentureOrderResponse
object
amount_cents
required
Amount Cents
integer
checkout_session_id
required
Any of:
string
checkout_task_id
required
Checkout Task Id
string format: uuid
checkout_url
required
Any of:
string
collected_cents
required
Collected Cents
integer
currency
required
Currency
string
Allowed value: usd
customer_email
required
Customer Email
string
dispatch_pending
required
Dispatch Pending
boolean
download_url
required
Download Url
string
fulfilled_at
required
Any of:
string format: date-time
id
required
Id
string format: uuid
last_checked_at
required
Any of:
string format: date-time
last_error
required
Any of:
string
last_verified_at
required
Any of:
string format: date-time
livemode
required
Livemode
boolean
paid_at
required
Any of:
string format: date-time
plan_id
required
Plan Id
string format: uuid
processor_fees_cents
required
Any of:
integer
processor_net_cents
required
Any of:
integer
refunded_cents
required
Refunded Cents
integer
report_sha256
required
Report Sha256
string
status
required
Status
string
tax_cents
required
Any of:
integer
title
required
Title
string
outcomes
Outcomes
Array<object>
VentureOutcomeResponse
object
actor_kind
required
Actor Kind
string
Allowed values: owner invitation_holder provider
causal_value_verified
Causal Value Verified
boolean
evidence_status
required
Evidence Status
string
Allowed values: attested verified unconfirmed
freshness
required
Freshness
string
Allowed values: current stale superseded
id
required
Id
string format: uuid
kind
required
Kind
string
Allowed values: customer_attestation owner_observation provider_observation
observed_at
required
Observed At
string format: date-time
order_id
required
Order Id
string format: uuid
payload
required
Payload
object
key
additional properties
any
plan_id
required
Plan Id
string format: uuid
recorded_at
required
Recorded At
string format: date-time
report_sha256
required
Report Sha256
string
supersedes_id
required
Any of:
string format: uuid
plans
required
Plans
Array<object>
VenturePlanResponse
object
approved_at
required
Any of:
string format: date-time
feedback
required
Any of:
string
id
required
Id
string format: uuid
proposal
required
Any of:
VentureProposal
object
assumptions
Assumptions
Array<string>
<= 20 items
confidence_score
required
Confidence Score
number
<= 1
estimated_credits
required
Estimated Credits
integer
<= 1000000
evidence
Evidence
Array<object>
<= 30 items
VentureEvidence
object
claim
required
Claim
string
>= 1 characters <= 3000 characters
retrieved_at
required
Retrieved At
string format: date-time
title
required
Title
string
>= 1 characters <= 500 characters
url
required
Url
string format: uri
>= 1 characters <= 2083 characters
reasoning
required
Reasoning
string
>= 1 characters <= 12000 characters
recommendation
required
Recommendation
string
Allowed values: go no_go research_more
risks
Risks
Array<string>
<= 20 items
steps
Steps
Array<object>
<= 12 items
VentureStep
object
arguments
required
Arguments
object
key
additional properties
any
bindings
Bindings
object
key
additional properties
string
depends_on
Depends On
Array<string>
<= 12 items
evidence_paths
required
Evidence Paths

Paths into THIS step’s output receipt, e.g. receipt.url or receipt.content for web_fetch. Start with receipt.; do not prefix with steps.. Tool receipt roots: web_search: results; web_fetch: url, content; create_content: content; execute_outreach: delivery_id, message_id, accepted_at; create_report_checkout: order_id, checkout_session_id, checkout_url, report_sha256; cms_publish: post_id, provider_post_id, publication_url; social_post_publish: social_post_id, platform_post_id.

Array<string>
>= 1 items <= 12 items
expected_outcome
required
Expected Outcome
string
>= 1 characters <= 2000 characters
key
required
Key
string
/^[a-z][a-z0-9_]{0,47}$/
owner_role
required
Owner Role
string
success_criteria
required
Success Criteria
string
>= 1 characters <= 2000 characters
title
required
Title
string
>= 1 characters <= 200 characters
tool_name
required
Tool Name
string
Allowed values: web_search web_fetch create_content execute_outreach create_report_checkout cms_publish social_post_publish
success_criteria
required
Success Criteria
Array<string>
>= 1 items <= 20 items
summary
required
Summary
string
>= 1 characters <= 6000 characters
status
required
Status
string
tasks
required
Tasks
Array<object>
VentureTaskResponse
object
agent_role
required
Agent Role
string
cost_usd
required
Any of:
string
/^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$/
error
required
Any of:
string
id
required
Id
string format: uuid
key
required
Key
string
output
required
Any of:
object
key
additional properties
any
status
required
Status
string
task_type
required
Task Type
string
version
required
Version
integer
status
required
Status
string
success_criteria
required
Success Criteria
string
title
required
Title
string
Example
{
  "economics": {
    "currency": "usd",
    "measurement_basis": "observed_live_receipts_partial_costs"
  },
  "orders": [
    {
      "currency": "usd"
    }
  ],
  "outcomes": [
    {
      "actor_kind": "owner",
      "causal_value_verified": false,
      "evidence_status": "attested",
      "freshness": "current",
      "kind": "customer_attestation"
    }
  ],
  "plans": [
    {
      "proposal": {
        "recommendation": "go",
        "steps": [
          {
            "evidence_paths": [
              "receipt.url",
              "receipt.content"
            ],
            "tool_name": "web_search"
          }
        ]
      }
    }
  ]
}

422

Section titled “422”

Validation Error

Media typeapplication/json
HTTPValidationError
object
detail
Detail
Array<object>
ValidationError
object
ctx
Context
object
input
Input
loc
required
Location
Array
msg
required
Message
string
type
required
Error Type
string
Examplegenerated
{
  "detail": [
    {
      "ctx": {},
      "input": "example",
      "loc": [
        "example"
      ],
      "msg": "example",
      "type": "example"
    }
  ]
}